[SciPy-dev] [SciPy-user] Docstring standards for NumPy and SciPy
oliphant at ee.byu.edu
Wed Jan 17 23:44:37 CST 2007
Robert Kern wrote:
> Travis Oliphant wrote:
>> After some more lively discussion, here is my latest proposal. We will
>> use reST for the docstrings with specific sections expected as given.
>> The Notes and Examples section are optional but the Examples section is
>> strongly encouraged.
> There's another section that we should encourage (since authors tend not to
> document it otherwise):
Good idea. There is a consolidated field named Exceptions that epydoc
recognizes which we could also use.
More information about the Scipy-dev