Oral Tradition in Software Engineering
Tim Daly <[email protected]>
| Newsgroups | gmane.comp.mathematics.axiom.devel |
|---|---|
| Message-ID | <CAJn5L=K8OuZD5WfxCnBjD2sfhTXv=Av1KW4G-COgMW70jKDGPw@mail.gmail.com> |
https://www.youtube.com/watch?v=4PaWFYm0kEw quoting one slide: 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 [email protected] https://lists.nongnu.org/mailman/listinfo/axiom-developer