> > This is true - but also keep in mind I am just trying to get the darn
> thing
> > working at this point.
>
> Good comments and style are an integral part of the code, and writing
> comments is an important and useful part of writing code. Writing good
> comments forces you to explain the purpose of each line, which points out
> most problems before they become bugs. Comments also show what you
> intended something to do, which is very useful to other people trying to
> help you with bugs. In the end, writing proper code with good style and
> comments right from the beginning gets you to the desired end faster.
> "Just getting it working" first, then adding comments later doesn't save
> time, it **costs** time. Also, the vast majority of times I've seen
> people use this method, the comments never do get added later.
>
> > THe way I code, I will get the basics working, and then
> > will proceed to optimize/comment it.
>
> Then you need to fix this first, especially before you ask others for
> help.
>
> > When I end up re-arranging half of the
> > stuff that I write, comments just become useless.
>
> Only if you allow them to or they were bad comments in the first place.
> Again, comments are an integral part of the code. If the code gets
> modified, the comments need to be modified with it.
>
> > Besides, they aren't causing
> > me the problem right now :-)
>
> WRONG!! Lack of attention to detail and general misconceptions may well
> be the problem. Writing good comments as an inseperable part of writing
> the code helps with both of these.
>
> Writing good comments is easy to do but apparently difficult to learn.
> The vast majority (well over 90% in my opinion) of code, including
> professionally written code, is poorly commented. Doing it right won't
> come overnight, but it will never come without the right attitude (maybe
> that's the hard part to learn?). Unfortunately most examples, including
> most things I've seen cross this list and everything I've seen from
> Microchip, are poorly commented. However, that doesn't make it right nor
> is it a valid excuse. Take a look at lots of source code at
>
http://www.embedinc.com/pic for examples of one way to do it right.
>
>
> *****************************************************************
> Embed Inc, embedded system specialists in Littleton Massachusetts
> (978) 742-9014,
http://www.embedinc.com
>
> --
>
http://www.piclist.com hint: To leave the PICList
>
RemoveMEpiclist-unsubscribe-request
spamBeGonemitvma.mit.edu
>