[Python-Dev] Missing docs (was Decimal rounding doc) (original) (raw)

Aahz aahz at pythoncraft.com
Fri Jul 1 17:43:57 CEST 2005

On Fri, Jul 01, 2005, Facundo Batista wrote:

On 7/1/05, Aahz <aahz at pythoncraft.com> wrote:

My suspicion is that someone at some point thought that Cowlishaw was sufficient; we probably should write some base-level docs that explain the Python mechanisms and refer to Cowlishaw for details. Well, it's already well explained, with examples and all, in the PEP 327: http://www.python.org/peps/pep-0327.html#rounding-algorithms I'll point to there from the Money PEP, but I think this should be somewhere in the docs. I mean, as a final user, you shouldn't read a PEP or a 3rd party doc to know how to use a module.

Agreed. Unfortunately, that's one big area where Python needs work; new-style classes are probably the worst. If you wanted to take the lead and push a sprint on doc work, you'd be a hero.

Aahz (aahz at pythoncraft.com) <*> http://www.pythoncraft.com/

f u cn rd ths, u cn gt a gd jb n nx prgrmmng.

More information about the Python-Dev mailing list