Wouter van Ooijen wrote:
>> - How many people have you EVER had to ask to document their code
>> LESS.
>
> Assembly program beginners (and sometimes C beginners too) tend to
> comment what the instructions do, like
>
> movlw 0x20 ; load value 0x20 into W
>
> n++; /* make n equal to n + 1 */
>
> I tell them to leave such comments out.
>
> OK, I also ask them to comment *why* 0x20 must be loaded in W, or why
> n must be incremented.

So this isn't a request to comment less, but comment better, and is part of
the important process of teaching your students to comment well.
Unfortunately, teaching good commenting is something all too rare.
Personally, I think source code submitted to a programming class should be
graded about equally on functional content and documentation.


********************************************************************
Embed Inc, Littleton Massachusetts, http://www.embedinc.com/products
(978) 742-9014.  Gold level PIC consultants since 2000.
-- 
http://www.piclist.com PIC/SX FAQ & list archive
View/change your membership options at
http://mailman.mit.edu/mailman/listinfo/piclist