[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Axiom-developer] Oral Tradition in Software Engineering

From: Tim Daly
Subject: [Axiom-developer] Oral Tradition in Software Engineering
Date: Tue, 29 Nov 2016 20:51:37 -0500

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.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]