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]
https://lists.nongnu.org/mailman/listinfo/axiom-developer