Well, I was saving this for a later review, but we'd like to avoid docstrings in favor of comments (for things internal to the code) and documentation in the manual (for things users or developers should know about).