Modulo typos and English errors, this is how a piece of software should look. Readable for the programmer.
Besides Knuth literate programming I've seen only one piece of software that looked as readable: the disassembly of Sinclair Spectrum ROM. Virtually every CPU instruction had a comment with it.
6 comments
[ 3.4 ms ] story [ 30.0 ms ] threadBesides Knuth literate programming I've seen only one piece of software that looked as readable: the disassembly of Sinclair Spectrum ROM. Virtually every CPU instruction had a comment with it.
Comments like this always go out of date because people don't reread every comment when they make a change.