FYI...

I have just seen a very nice presentation [1] about writing good documentation. The presenter mentions Sphinx, but also two things I was not aware of:

• documentation hosting site [2] - I have already registered, but did not import sfepy there yet, as we do use custom (numpy) sphinx extensions

• pycco [3] - a literate programming tool.

The talk also stresses that it's primarily the developers who should write the docs, not the (new) users, so I will get better :)

r.

[1] http://pycon.blip.tv/file/4881071/ [2] http://readthedocs.org/ [3] http://fitzgen.github.com/pycco/