If the tool chain needs to be structured to facilitate people writing programs and documentation and comments, why isn't Literate Programming more popular?
http://literateprogramming.com/
Is LLM what will finally push LP into mainstream acceptance?
https://news.ycombinator.com/item?id=47300747