[development] QA: Consensus on comment formatting

Robert Douglass rob at robshouse.net
Mon Jan 8 14:20:06 UTC 2007


Just adding my agreement to the following comment. There is good IDE 
support for these:

Rob Barreca wrote:
>> * Eliminate inappropriate uses of all caps, e.g, NOTE. 
> Think we should allow NOTE and WARNING as long as they are used like 
> TODOs -- with a capitalized sentence/period. All these are good in my 
> mind.
>
> // TODO: Optimize this query.
> // WARNING: Don't do that.
> // NOTE: May smell funky.



More information about the development mailing list