如果您的项目是在github上托管的,那么现在使用github的wiki可能会更好一些.
如果您还想自动生成文档,那里有更好的解决方案 – pydoc是一个,但还有其他的,如Sphinx或最新到达,Dexy.