Encapsulation, inheritance and polymorphism

Steven D'Aprano steve+comp.lang.python at pearwood.info
Fri Jul 20 09:24:23 CEST 2012


On Thu, 19 Jul 2012 09:06:45 -0400, Roy Smith wrote:

> Heh.  This reminds me of one of my current pet peeves.  I've run across
> documentation for more than one Python project (django is the one that
> comes to mind, but I'm sure there's others) which misuse words like
> "set" and "list".  They're often used in the generic sense of "a
> collection of things", but they're also the names of specific Python
> data types.  It can sometimes get confusing trying to figure out which
> meaning they intended.

Now that is confusing!

Writing good documentation is *hard*. I often end up writing more 
documentation than code, sometimes by a factor of two. Fortunately I love 
to write. As may be obvious.



-- 
Steven



More information about the Python-list mailing list