On Sun, Sep 08, 2013 at 09:14:39PM +0100, Paul Moore wrote:
On 8 September 2013 20:19, Steven D'Aprano firstname.lastname@example.org 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 :-)