[Numpy-discussion] Tests and code documentation

Alan G Isaac aisaac at american.edu
Thu Sep 21 18:58:35 CDT 2006


On Thu, 21 Sep 2006, "David M. Cooke" apparently wrote: 
> Foremost for Python doc strings, I think, is that it look 
> ok when using pydoc or similar (ipython's ?, for 
> instance). That means a minimal amount of markup. 

IMO reStructuredText is very natural for documentation,
and it is nicely handled by epydoc.

fwiw,
Alan Isaac






More information about the Numpy-discussion mailing list