We're also trying to build a resource around this kind of information on docs.writethedocs.org. It just launched today as part of this, and is half baked. However, this is the start of that doc: http://docs.writethedocs.org/en/latest/starting.html

It isn't so much about how to write documentation, but adding that section is something we want to do.

We also have a section currently linked to a couple of interesting projects: http://docs.writethedocs.org/en/latest/about/alternatives.ht...