On Fri, 07 Mar 2008 20:04:47 -0800, dave_mikesell wrote:

> On Mar 7, 10:31 am, "K Viltersten" <[EMAIL PROTECTED]> wrote:
>> I've been recommended reading
>> of:http://www.python.org/dev/peps/pep-0008/ and in there i saw two
>> things that i
>> need to get elaborated.
>>
>> 1. When writing English, Strunk and
>> White apply.
> 
> If your code needs so much descriptive prose that you have to consult
> Strunk and White, refactor it to be more clear.   Excessive comments are
> the hobgoblin of overly complex and/or sloppy code.

Nonsense. Poor English is poor English whether you're writing short one-
line comments or three hundred page manuals.

store = make_store()
x = get_stuff(store)  # Get the stuff what was brought at the store.

Not that I would consider S & W the best source for good grammar or style.



-- 
Steven
-- 
http://mail.python.org/mailman/listinfo/python-list

Reply via email to