This is, as far as I'm concerned, one of the great weaknesses of
Python. (One of a
relatively few, to be honest--I'm still an enthusiast after all!)
There are numerous docstring-oriented tools; in my opinion, none of
them are satisfactory,
because docstrings only apply to certain entities, and
On Oct 05, Kalle Anke wrote:
> I'm confused of how I should document my code, I've always liked being
> able to document my code directly in my source file and then to use
> some tool to extract the documentation to some other format.
> My problem with Python is that there are so many tools and fo
I'm confused of how I should document my code, I've always liked being able
to document my code directly in my source file and then to use some tool to
extract the documentation to some other format.
My problem with Python is that there are so many tools and formats ... I
don't know which one I
