I’ve been reading a bit about Literate Programming recently, and it got me thinking… Well-written tests, especially BDD-style specs can do a better job at explaining what code does than prose does, and have the big advantage of verifying their own accuracy.