CodeDown = Markdown as the universal language for program documentation
waylan at gmail.com
Tue Apr 12 10:52:24 EDT 2011
On Tue, Apr 12, 2011 at 9:04 AM, Rob McBroom <mailinglist0 at skurfer.com> wrote:
> On Apr 11, 2011, at 5:46 PM, David Chambers wrote:
> Check out Jeremy Ashkenas's docco. Truly beautiful.
> People might also be interested in appledoc, which uses Discount to parse
There is also Apydia , which uses Python-Markdown (or textile or
reStructuredText) on Python code.
However, the really powerful documentation library in Python (also
supports C/C++ with other language promised to be coming) is Sphinx
. Unfortunately, is uses reStructuredText, not Markdown. Now, if
someone created a similar tool that used Markdown, that would be
The great thing about Sphinx is that while is can extract comments
from the source, it is primarily meant to write documentation separate
from the source - which should almost always be a projects primary
documentation. The automatically-generated-from-source reference
should usually be in addition to the primary documentation. At least,
that is if you want a well documented project.
\X/ /-\ `/ |_ /-\ |\|
More information about the Markdown-Discuss