[SciPy-dev] docs.scipy.org -- new site for the documentation marathon
Jarrod Millman
millman at berkeley.edu
Sun Oct 26 13:44:36 EDT 2008
On Sun, Oct 26, 2008 at 10:41 AM, Pauli Virtanen <pav at iki.fi> wrote:
> I think we will in the end need both brief API reference documentation
> (docstrings etc., explanations of common semantics such as dtype
> specifications) and then more detailed usage documentation. The current
> Sphinx docs are brief because they almost exclusively contain only the
> former, and for Scipy, mostly only the docstrings are there.
>
> To me, it would make sense to keep all the documentation as closely
> integrated as possible -- then you can use Sphinx's cross-referencing,
> indexing, glossary, math, etc. facilities, and the documentation will be
> easy to find, searchable, and have consistent appearance.
+1
If my opinion isn't obvious all ready ;)
--
Jarrod Millman
Computational Infrastructure for Research Labs
10 Giannini Hall, UC Berkeley
phone: 510.643.4014
http://cirl.berkeley.edu/
More information about the SciPy-Dev
mailing list