There was a fantastic set of panel discussions at MIT on dynamic languages in 2001. In the Q&A period of the panel on runtime [1] Guy Steele asked the panel wh

There was a fantastic set of panel discussions at MIT on dynamic languages in 2001. In the Q&A period of the panel on runtime [1] Guy Steele asked the panel what they thought about literate programming [2], and some good discussion ensued. Some points made that I particularly liked were the point that people generally don't even make the effort to keep comments up-to-date, much less writing them well in the first place, never mind thinking about a good order for the human to read them in. [1] https://www.youtube.com/watch?v=4LG-RtcSYUQ https://www.youtube.com/watch?v=4LG-RtcSYUQ [2] https://www.youtube.com/watch?v=4LG-RtcSYUQ#t=1h21m43s https://www.youtube.com/watch?v=4LG-RtcSYUQ#t=1h21m43s (discussion lasts about five minutes, participants include David Moon, Scott McKay, and Guy Steele)