Marco Buttu <marco.bu...@gmail.com>: > To acknowledge the OP, the statistics module deserves to be taken as > example for writing good comments and docstrings: > > https://hg.python.org/cpython/file/3.4/Lib/statistics.py
True, it is done with good style. It concentrates on documenting use and lets the implementation document itself. Marko -- https://mail.python.org/mailman/listinfo/python-list