[SciPy-Dev] scipy.stats documentation

[Ralf Gommers]

On Mon, May 7, 2012 at 10:03 PM, Skipper Seabold <jsseabold at gmail.com>wrote:

> On Mon, May 7, 2012 at 3:41 PM, <josef.pktd at gmail.com> wrote:
> >
> > On Mon, May 7, 2012 at 2:20 PM, nicky van foreest <vanforeest at gmail.com>
> wrote:
> >
> >
> > >
> > >> Sometimes the parameterization in stats.distributions is "a bit
> > >> difficult" to translate to the standard parameterization, example
> > >> lognormal that regularly raises questions.
> > >
> > > Ok. Can we resolve this by making the doc-string more explicit, like
> > > my example above?
> >
> > Yes
> >
> > >
> > >> these are generic template numbers and could be replaced by
> > >> distribution specific docstrings
> > >
> > > Ok. How about fixing part for part?
> >
> > If someone is going through individual distributions, this would be
> > very good. (My initial worry a few years ago was that it will be
> > difficult to maintain 90 individual docstrings.)
> >
>
> Sure re-using the templates is useful (except when they generate
> incorrect information such as the wrong number of args and non-integer
> args, etc.), but it seems like (to me) confusion still reigns here. I
> don't know how the docs work anymore, but is it possible to have a
> wiki-editable 'Notes' section for each distribution? I think having a
> lot more information individually would go a long way.
>

They do (the distname_gen pages, as Josef pointed out), with the exception
of a few discrete distributions.

Ralf
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scipy-dev/attachments/20120507/8f8ab502/attachment.html>