Experimental Physics and
Industrial Control System

"Dalesio, Leo `Bob`" <[email protected]> · Fri, 8 Sep 2006 09:45:13 -0700

As the question must not be serious -
I'll state the obvious......

Code always tells the truth. Comments sometimes do not.

Documentation says how to use it.
Reading the code tells you how to modify it.

It is good practice for the comments to at least get you to the modules and subroutine that you are looking for. Once inside - you get what you get.

Personally, I write comments for me - I have a short memory.
There are very talented programmers that have done a lot of the base code, that do not trust anything but the code. They would read the code regardless of the presence of comments. They obviously don't need comments.

Experimental Physics and Industrial Control System

Experimental Physics and
Industrial Control System