[SciPy-Dev] Status of scipy.* docstrings
Thu Aug 5 06:23:14 CDT 2010
On Thu, Aug 5, 2010 at 7:10 AM, Scott Sinclair
> On 5 August 2010 12:55, <firstname.lastname@example.org> 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.
> SciPy-Dev mailing list
More information about the SciPy-Dev