Re: [OpenWeBWorK-devel] coding standards

[John J. <jj...@as...>]

Sam Hathaway wrote:

> Fairly new on the wiki:
>
> http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/ 
> CodingStandards
>
> Please read, comment, disagree, etc.

It looks pretty good. 

I don't know if this would be a change, or just an addition, but I would 
follow a different convention when commenting out a chunk of code (as 
opposed to a single line).  Then, I prefer commenting everything with # 
in the first column (by everything, I include previously commented lines 
and blank lines).  It leaves the old indentation in tact so it is easy 
to read what was there, and it is easy to scan past to see where the 
commenting starts and ends.  It is also what emacs's comment-region does 
by default (which was written by people who like to debate things like 
code formatting).

John