Most gratuitous comments

Marko Rauhamaa marko at pacujo.net
Fri Nov 21 01:52:47 EST 2014


sohcahtoa82 at gmail.com:

> My point was that I was making fun of CS professors that demand a
> comment on every line of code, regardless of how clear the line of
> code is.

Unfortunately, a lot of software houses do a similar thing. Not quite
every line, but stuff like:

   def write_line_to_file(file, line):
       """Write a line to a file.

          file is the file to add a line to
          line is the line to add to the file"""
       ...


Marko



More information about the Python-list mailing list