Comments on: A Taxonomy of Comments

By: Bit Banger

Bit Banger — Thu, 04 Sep 2003 08:05:22 +0000

Link-fu Volume 10
The triumphant return! This edition sans outline format. Apple’s history, ScummVM for P800 phones makes me jealous, information clients and Oliver Steele on comments (but I like it for its reflections on software construction and what programming langu…

By: Ned Batchelder

Ned Batchelder — Sun, 31 Aug 2003 15:05:03 +0000

Comments say why
There’s a thread going around about comments in source code.

By: Ned Batchelder

Ned Batchelder — Sun, 31 Aug 2003 15:04:20 +0000

Comments say why
There’s a thread going around about comments in source code.

By: Ted Leung on the air

Ted Leung on the air — Sun, 31 Aug 2003 10:50:09 +0000

Comments as metadata
Oliver Steele has a
long post categorizing the various uses of comments. Along the way, he stratifies macro systems into structural macros and definition-level macros, and relates those to explict programming.

He concludes with a section about

By: Roland Tanglao's Weblog

Roland Tanglao's Weblog — Sun, 31 Aug 2003 09:29:00 +0000

A Taxonomy of Comments
(SOURCE: A Taxonomy of Comments )- Yes! Comments are important for describing non-obvious optimisations and logic.