I have a project that intents to subsume and improve on Python's doctest called Manuel. The Manuel documentation explains more and is written/tested using Manuel so it provides a good example of it in use: <a href="http://packages.python.org/manuel/" rel="nofollow">http://packages.python.org/manuel/</a><p>The download is available from PyPI: <a href="http://pypi.python.org/pypi/manuel/" rel="nofollow">http://pypi.python.org/pypi/manuel/</a>