[SciPy-Dev] Cross-link scipy docs and source code?
Sun Mar 11 08:05:00 CDT 2012
On Sun, Mar 11, 2012 at 7:51 AM, Christoph Deil
> would it be possible to cross-link the scipy docs and source code?
> I would find that very useful and I could imagine that this might in the
> long run lead to more scipy contributors (see recent mailing list thread
> that there are too few of those).
> More users will start to browse the code and understand how things are
> implemented and eventually feel competent enough to add the features they
> need in scipy instead of writing their own modules / wrappers based on
> Here's an example that shows how scipy docs currently look (no link to
> source code):
> statsmodels is an example of a package that has cross-linked their auto
> docs and source code:
IIRC, we added the source in statsmodels by accident, however I don't
find any discussion anymore.
It's a bit similar to the (old style) DOXYGEN generated documentation.
I don't think sphinx would handle parts of scipy that are not in
I like having quick access to the source to see what a function
actually does. For scipy, I rely most of the time on the object
inspector in Spyder that is able to pull up the docstring and the
source, or sometimes on numpy.source
The only thing I would worry a bit with adding the source is the size
of the htmlhelp, but I don't think it will get too large or sluggish.
> SciPy-Dev mailing list
More information about the SciPy-Dev