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

[Aahz]

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.