Re: Encouraging good comments Which language ?

[HyperHacker <hyperhacker@...>]

On Sun, Jan 29, 2012 at 18:20, Rob Kendrick <rjek@rjek.com> wrote:
> On Sun, Jan 29, 2012 at 05:57:42PM -0700, YES NOPE9 wrote:
>> If this question has been addressed previously.... please point me in the correct direction.
>>
>> What language is most likely to encourage good commenting ( What is being done and why ? )  and make the code easier to support by a future maintainer  ?
>> Or is this just not something that is influenced by the language......
>
> If I'm expected to support the code, it would have to be English.
> Otherwise, perhaps Lojban? :)
>
> B.
>

Good comments explain what the code is doing, and why - not how.
(That's what the code is for.) You should be able to understand the
code months later when all those clever tricks are no longer fresh in
your mind.

Or did you mean mailing list comments?

-- 
Sent from my toaster.