[Numpy-discussion] coding style: citations
Alan G Isaac
Sun Jan 11 14:55:28 CST 2009
The docstring standard at
suggests a citation reference format that is not compatible
with reStructuredText. Quoting from
Citations are identical to footnotes except that they use
only non-numeric labels such as [note] or [GVR2001].
In other words, the standard currently promotes a conflation of
notes and citations.
Another reason for avoiding the style currently in the docstring
standard is that it renders impossible the generation of citations
using a citation database. (See e.g. the bibtext-like facilities offered
by bibstuff's bib4txt (http://code.google.com/p/bibstuff/).
More information about the Numpy-discussion