[SciPy-Dev] Status of scipy.* docstrings

josef.pktd@gmai... josef.pktd@gmai...
Thu Aug 5 06:23:14 CDT 2010

On Thu, Aug 5, 2010 at 7:10 AM, Scott Sinclair
<scott.sinclair.za@gmail.com> wrote:
> On 5 August 2010 12:55,  <josef.pktd@gmail.com> wrote:
>> A related question that is not urgent: Are we keeping the split of
>> information between tutorial and sub-package rst pages, or should some
>> background information be moved to the package rst files ?
> I think it makes sense to keep a split between the two. Tutorials
> should describe how to use a selection of the sub-package tools by
> example, while the sub-package rst pages should be the top level of
> reference documentation for the sub-package.

Some tutorial pages also contain the mathematical definitions and
background explanations of the algorithms, e.g. signal.lfilter and
fft, just two examples that I remember. Also having the
definitions/formulas of the stats.distributions in the tutorials hides
them a bit.

Those parts might better belong in a package documentation. Usage
examples of course should remain in the tutorials.



> Cheers,
> Scott
> _______________________________________________
> SciPy-Dev mailing list
> SciPy-Dev@scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-dev

More information about the SciPy-Dev mailing list