From my point of view, the docstring of class rv_discrete() was poorly understandable.
The problem was:
Most of examples were not directly executable and mostly illustrated the ' Alternatively' section in notes.
In the new version,
I have not fully understood yet examples using . But I think we must avoid examples that could not be executed "out of the box". For the moment, still there...
DOC: improve consistency
MIN: fix typo
DOC: reorganize the docstring
Could you tweak the example a little to use standard namespaces? So
from scipy import stats
Other than that this looks good.
Docstring: std namespace