While we're discussing readability (was Re: Language change and code breaks)

Sam Penrose sam at ddmweb.com
Fri Jul 20 14:05:36 EDT 2001


Python is and will in all likelihood remain a marvel of readability.
Two nits to pick:

I would argue that keystroke-saving has been taken too far when common
functions have had just enough characters chopped to obscure their
meaning to a novice. "len", "del", and "repr" should have been "length",
"delete", and "represent". They can't be changed, but they shouldn't be
emulated.

Second, the standardization of docstrings, if applied with a heavy
hand, could result in more and more modules that are very hard to scan
because you can't see the code for more than one function/method on a
even a 1600x1200 screen. Not every handler should have a docstring, and
not every docstring should be lavishly sprinkled with whitespace and
variable definitions.




More information about the Python-list mailing list