"I completely disagree that modern languages have removed all restrictions." So do I. That's why I said the marginal advantage makes it not worth it, and said

"I completely disagree that modern languages have removed all restrictions." So do I. That's why I said the marginal advantage makes it not worth it, and said already that literate programming does things that conventional doesn't. (If you don't know what a marginal advantage is, you may want to poke around on the internet a bit. It's a very valuable concept. And I see a lot of people using the word in a way that shows they don't really know what it means; it is commonly thought that it means something "small" or "insignificant". That's not what it means.) "There is nothing to tell you this information in a typical program." This is true, but it's not true because nobody uses strict Knuthian literate programming, it's because nobody is writing those. Languages generally do have a place to put a top-level summary and organize all the rest of the documentation. I know; I use them and write them. All my major systems have an official "top level" location, and generally I put it in the local system's language-specific documentation format (godoc for most of my systems). People just don't write them. Handing them better tools won't solve that problem.