A combination of both, something like Knuth's idea for Literate Programming, would be the best I think. Of course that would be way more work for whoever has t

A combination of both, something like Knuth's idea for Literate Programming, would be the best I think. Of course that would be way more work for whoever has to type it all up, so I don't think it has much of a chance to catch on.