Here are some links regarding reStructuredText used in Python docstrings (source code comments) and Sphinx, Python's new documentation system:
Notes, commentary, and other drivel on all aspects of software development, with the occasional off topic bits thrown in.