Literate Programming
About a decade ago, I discovered the concept of Literate Programming. It's seductive. The idea is to write elegant documentation that embeds the actual working code.
For tricky, complex, high-visibility components, a literate programming approach can give people confidence that the software actually works as advertised.
I actually wrote my …
more ...