[SciPy-Dev] scipy.stats documentation

Skipper Seabold jsseabold at gmail.com
Mon May 7 16:23:44 EDT 2012


On Mon, May 7, 2012 at 4:18 PM, Ralf Gommers
<ralf.gommers at googlemail.com> wrote:
>
>
> 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.
>

Ah good. The link didn't work for me, but I see it in the source now.

Skipper



More information about the SciPy-Dev mailing list