One problem with (Python) docstrings is that they're local

Python docstrings are attached to functions and scattered throughout code, making them local documentation. They work well for summarizing individual functions but poorly for providing overviews or documenting complex interactions between components.