>>346が大前提だねー。メタ情報とかの諸々は外部で管理した方が良いと思う。
docstringが長くなると、画面あたりの情報量が減って、可読性が大幅に下がるし。

10年、20年単位で保守・管理するためのツールがSCMやissue trackerとかで、
情報の管理もそちらで行うのが常識になってる。

最近はみんな、趣味のコードの管理にはGitHubかBitbucket使ってるよね。