Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #6343 > unrolled thread

Re: The worth of comments

Back to article view | Back to comp.lang.python

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.

Contents

  Re: The worth of comments "Patty" <patty@cruzio.com> - 2011-05-26 13:30 -0700

#6343 — Re: The worth of comments

----- Original Message ----- 
From: "Richard Parker" <r.richardparker@comcast.net>
To: <python-list@python.org>
Sent: Thursday, May 26, 2011 11:50 AM
Subject: The worth of comments


> On May 26, 2011, at 4:28 AM, python-list-request@python.org wrote:
>
>> My experience is that comments in Python are of relatively low
>> usefulness. (For avoidance of doubt: not *zero* usefulness, merely low.)
>> I can name variables, functions and classes with sensible, self-
>> documenting names. Why write:
>>
>> x = get_results(arg)  # x is a list of 1 or more results
>> [... much later]
>> for y in x:
>>    # process each result in turn
>>    do_something_with(y)
>
> (It occurred to me that I should use a specific subject for this 
> discussion.)
>
> I'm less inclined to use comments on each line, or selected lines, but 
> rather use block comments instead. They require more thought and time to 
> write; however, the intended functionality of the code that follows can be 
> described in full.
>
> -- 
> http://mail.python.org/mailman/listinfo/python-list
>
>

Hello Richard - I was recently complimented in a phone screen interview for 
including comment blocks exactly as you describe above.

Regards,

Patty 

[toc] | [standalone]

Back to top | Article view | comp.lang.python

csiph-web