> why literate programming isn't more popular is beyond me

I saw this topic brought up in a video I was watching yesterday https://youtu.be/SzA2YODtgK4?t=1519

There are 2 reasons:

1. Programmers and code review tools are not very good at making sure comments and documentation are updated when code is.

2. People see literate programming as primarily for documentation-focused or teaching purposes.

The statistics in the article we're commenting on suggest that more software systems should be documentation/teaching focused, since the "learning the system" phase is where most of the time goes.