In my experience current Python culture takes documentation very seriously. Popular projects like Django, SQLAlchemy, South, Pyramid, Fabric have extensive narr

In my experience current Python culture takes documentation very seriously. Popular projects like Django, SQLAlchemy, South, Pyramid, Fabric have extensive narrative documentation (in the form of an overview, a tutorial, a thematic guide, and finally a reference section). In contrast, I was pretty frustrated using Capistrano and finding third-party documentation scattered across blog posts and wikis. This excellent culture is enabled by Sphinx, which makes it easy to publish documentation as static html content (and pdf and epub). Hosting on python.org and readthedocs.org makes it even easier to put great documentation online, and it is one of the best ways to brand a project as something people can build on.