1 Apr
2011
1 Apr
'11
1:55 p.m.
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/