I read this as the author advocating for some form of "comments first" development philosophy. As such, I'd like to submit this well known bit of work by Knuth

I read this as the author advocating for some form of "comments first" development philosophy. As such, I'd like to submit this well known bit of work by Knuth for consideration (by anyone not already familiar with it): https://en.wikipedia.org/wiki/Literate_programming https://en.wikipedia.org/wiki/Literate_programming IME that gives all a starting point or base line for discussions around "what can more/good/better comments and support for documentation do for me".