Re: Writing, Coding, and Professionals

Guy Macon <http://www.guymacon.com/>
writes:
>A good programmer writes his/her comments in such a way that 
>a far better programmer could, in theory, start with just the 
>comments and end up with a working program that does the same 
>basic job that the original program does. 

You want the complete specifications in the comments.

For most programs a complete specification is never written, so it
would certainly be an improvement if it was.  However, I don't see why
it should be in the comments.  Ok, an advantage would be that it would
be more likely to be updated when the requirements change (rather than
just updating the code).  But OTOH interspersing the spec with code
and structuring it in the same way as the code makes it harder to
understand.

- anton
-- 
M. Anton Ertl  http://www.complang.tuwien.ac.at/anton/home.html
comp.lang.forth FAQs: http://www.complang.tuwien.ac.at/forth/faq/toc.html
     New standard: http://www.forth200x.org/forth200x.html
   EuroForth 2008:
http://www.complang.tuwien.ac.at/anton/euroforth/ef08.html