Hi William,
> About comments-- personally, I never read them -- I've never found a > bug or fixed a bug in the comments. :-) > > I did find bugs in comments, and sometime fixed them. The code is saying something, comments the contrary. Which should the authoritative answer ? Should code do what comments say ? Or did code was fixed, but comments not updated ? That's why comments should be read, and updated as needed. FWIW, JSG says: "The comment should describe why your code does its thing, not what is does. That should be obvious from the code itself.". We could add one I like: "by obvious, we mean: if you're not able to explain loudly a piece of code, before your very first coffee the Monday morning, then your code isn't obvious"... Cheers, --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "jallib" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/jallib?hl=en -~----------~----~----~----~------~----~------~--~---
