Oral Tradition in Software Engineering

Previous Topic Next Topic
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view

Oral Tradition in Software Engineering

Tim Daly
Comments as oral tradition

The best comments seem to have an aspect of oral tradition
to them; they not only explain what is going on but
provide a narative as to why.

Comments live with the code but do not otherwise affect its
correctness -- allowing for broad scope and artistic license.

Relevant, correct software systems will survive long past their
creators; comments are the art within the timeless machine.

Comments are how we speak to future generations.

Axiom-developer mailing list
[hidden email]