Re: RFC: Guide for maintaining software in the Zope repository
Philipp von Weitershausen <[email protected]>
| Newsgroups | gmane.comp.web.zope.zope3 |
|---|---|
| Message-ID | <[email protected]> |
On 24 Aug 2007, at 19:55 , Dieter Maurer wrote: > Andreas Jung wrote at 2007-8-24 19:35 +0200: >> ... >> Whitespace rules have a major impact on the readability of code. >> Readability is a major point when we talk of code quality. >> Readable code >> does not make code automatically but good code has to be readable. > > Lots of whitespace does not make the code more readable for all > persons -- it does not for me, for example. > > Other rules are more important: > > * use speaking names > > * ensure that a "unit" (e.g. a function definition) can been > seen in its > whole > > * carefully document complex operations > > * combine a general overview with detailed source documentation. These are all excellent points. THat doesn't mean that the right usage of whitespace can't make code more readable. Anyway, I think this will be my last response on the style guide issue because we all are mostly on the same page, and we're we not it's a matter of taste and that's hard to argue about.