On 09/28/2015 12:39 PM, Stefan Monnier wrote:
>> There are some documentation frameworks available, e.g. Doxygen.
>> It might be a good idea to use one of them instead of trying to define
>> your own syntax.
> 
> Using doxygen sounds like a good idea.
> 
> Since the only thing we really need to formalize is the place and format
> of the "compiled" docstrings (e.g. "a DOC file"), there could even be
> several tools available which allow placing the docstring in various
> ways in the source code.  And each module could use the tool it prefers.

Do we even need this optimization in the modern world? Life would be
simpler if we could just get rid of the lazy-loaded documentation string
machinery.