On 5/20/07, Robert Kern <[EMAIL PROTECTED]> wrote:
Gael Varoquaux wrote: > Hi all, > > There is a very interesting discussion and python-dev and Doc-SIG about > using reST to document python. I think that the ongoing effort to > document numpy and friends with reST could benefit from interaction with > these guys. Not particularly. They are solving a different problem there: moving from the existing LaTeX system for manual documentation to reST. It doesn't have much to do with docstrings and automatically generated API docs, which is what we've been talking about.
It looked like a nice way to generate a manual and was nicely organized and pleasant to look at. For the moment I think we can continue to work on the docstrings but it is good to keep thinking about where it might fit in a larger scheme. It will be interesting to see if anything happens with the interactive patching. Chuck
_______________________________________________ Numpy-discussion mailing list [email protected] http://projects.scipy.org/mailman/listinfo/numpy-discussion
