(Python) ドックストリングの問題点の一つは、それがローカルであること

Pythonのドックストリングは関数に付随するため、コード全体に散在し、関連する情報を見つけるにはコードを読み進める必要がある。関数自体の要約としては有効だが、どの関数を探すべきかを見つけるための索引としては機能せず、コードと混在して全体像を把握しにくいという問題がある。