Encapsulation, inheritance and polymorphism
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.
More information about the Python-list