[Date Prev][Date Next][Thread Prev][Thread Next]
[Date Index]
[Thread Index]
- Subject: Re: Encouraging good comments Which language ?
- From: Petite Abeille <petite.abeille@...>
- Date: Mon, 30 Jan 2012 19:09:55 +0100
On Jan 30, 2012, at 6:46 PM, Max de Bayser wrote:
>> http://lua-users.org/wiki/LuaAnnotate
>
> Interesting, but I think there are two drawbacks to this approach.
Agree. But if you look past that specific implementation, the gist of it is to look at comments as external annotations, enrichments, that provide a more layman narrative of the code.
Another source of such narratives might be revision control commit logs.
An interesting thing to do might be to unify these various stories (the code, the annotations, the logs, the diffs, etc) into a more coherent and interactive whole.
- References:
- Encouraging good comments Which language ?, YES NOPE9
- Re: Encouraging good comments Which language ?, Rob Kendrick
- Re: Encouraging good comments Which language ?, HyperHacker
- Re: Encouraging good comments Which language ?, Axel Kittenberger
- Re: Encouraging good comments Which language ?, Petite Abeille
- Re: Encouraging good comments Which language ?, Axel Kittenberger
- Re: Encouraging good comments Which language ?, Petite Abeille
- Re: Encouraging good comments Which language ?, Axel Kittenberger
- Re: Encouraging good comments Which language ?, Petite Abeille
- Re: Encouraging good comments Which language ?, Axel Kittenberger
- Re: Encouraging good comments Which language ?, Petite Abeille
- Re: Encouraging good comments Which language ?, Max de Bayser
- Re: Encouraging good comments Which language ?, Petite Abeille
- Re: Encouraging good comments Which language ?, Max de Bayser