6 ms·

I always liked the idea of literate programming, but it never seemed to get a toe in the door. A good start would be just commenting code! Almost all the code

by drpixie 9mo ago

I always liked the idea of literate programming, but it never seemed to get a toe in the door. A good start would be just commenting code! Almost all the code I've looked into recently has been startling - the only comments are the licence boilerplate at the top of each file! I can think of only one product/library/package that was commented to explain what was happening. Go look at the source for a random package that you depend on. If you're really lucky, there might be something hinting at the meaning of function arguments, but like as not, not even that ;(

WillAdams 9mo ago
List of Literate Programs published as books: https://www.goodreads.com/review/list/21394355-william-adams?ref=nav_mybooks&shelf=literateprograms https://www.goodreads.com/review/list/21394355-william-adams... The main website for this of course lists some resources: http://literateprogramming.com/ http://literateprogramming.com/ most notably: http://literateprogramming.com/adventure.pdf http://literateprogramming.com/adventure.pdf (the source code of the venerable Colossal Cave Adventure re-worked as a Literate Program by Dr. Donald Knuth)