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 -- http://mail.python.org/mailman/listinfo/python-list