[Python-Dev] PEP 450 adding statistics module

Steven D'Aprano steve at pearwood.info
Mon Sep 9 05:27:22 CEST 2013


On Sun, Sep 08, 2013 at 09:14:39PM +0100, Paul Moore wrote:
> On 8 September 2013 20:19, Steven D'Aprano <steve at pearwood.info> wrote:
> [...]
> > Is this satisfactory or do I need to go into more detail?
> 
> It describes only 7 functions, and yet you state there are 11. I'd
> suggest you add a 1-line summary of each function, something like:
> 
> mean - calculate the (arithmetic) mean of the data
> median - calculate the median value of the data
> etc.

Thanks Paul, will do.

I think PEP 1 needs to be a bit clearer about this part of the process. 
For instance, if I had a module with 100 functions and methods, would I 
need to document all of them in the PEP? I expect not, but then I didn't 
expect I needed to document all 11 either :-)



-- 
Steven


More information about the Python-Dev mailing list