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