Your current filters are…
Hosting open source documentation was a mess. The best-of-class solution for the Python world as uploading a tarball of html to packages.python.org or doing similar to upload to github pages. If you wanted to self-host it, that generally meant having a cron job that ran a shell script to pull your source code nightly. We set out to solve this problem using the current best of class tools that Django has to offer.
"Read the Docs":http://readthedocs.org/ is the official documentation host for many open source Python projects. It is built around the "Sphinx":http://sphinx.readthedocs.org/en/latest/index.html documentation toolkit. In the simplest form, we are a hosting provider for Sphinx documentation. However, we have added a lot of features to make this useful. These include:
Read the Docs has a lot of the standard parts of any website, and also some other intersting parts that are relatively unique. These include:
This talk will consist of three parts. The first part is the origin story of the site, how and why it was created over a weekend by 3 people. Then I'll talk about the technology involved as the site has grown. It started out as a very simple site, but as features have been added, it has gotten more complex. Finally I will discus some of the interesting outcomes that come from having a completely open source site, including security and community contributions.
21st–24th June 2011