Mon, 15 Jun 2009 09:52:05 -0700, David Goldsmith kirjoitti:
[clip]
> Is there a protocol for making sure these things get done? (Just don't
> want to reinvent the wheel.)
I don't think so.
The current way is that people forget to do it, and then someone fixes it
afterwards :)
I'm not sure how much rubber hose we can use on developers. But please,
* When you add new functions in Python APIs, please
insert the function to the correct autosummary:: directive in
the correct RST file under doc/source/reference/routines.* *
* When you add new functions in the C APIs, please
insert at least stub function documentation (cfunction::
directives) in the corresponding RST file
doc/source/reference/c-api.* *
Sphinx has some coverage assessing features which we probably should try
out. There's also doc/summarize.py in Numpy's SVN that should report the
status, but it's currently broken.
--
Pauli Virtanen
_______________________________________________
Numpy-discussion mailing list
Numpy-discussion@scipy.org
http://mail.scipy.org/mailman/listinfo/numpy-discussion
