[New-bugs-announce] [issue27825] Make the documentation for statistics' data argument clearer.

[Ned Batchelder]

New submission from Ned Batchelder:

The docs for statistics.mean say, "Return the sample arithmetic mean of data, a sequence or iterator of real-valued numbers."  Most of the functions in statistics have a `data` argument, but this function is the only one that says, "a sequence or iterator."  The examples all show lists.

The page would be better if the introduction mentioned what `data` could be, instead of having to guess that median can take an iterator because mean says that it can.

----------
assignee: docs at python
components: Documentation
messages: 273318
nosy: docs at python, nedbat
priority: normal
severity: normal
status: open
title: Make the documentation for statistics' data argument clearer.

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27825>
_______________________________________