this seems fundamentally similar to the idea of literate code, where the domain and context-specific information like comments (and in TFA, function and variabl

this seems fundamentally similar to the idea of literate code, where the domain and context-specific information like comments (and in TFA, function and variable names) are put front and center. This approach makes more sense to me though, as literate programming emphasises writing a book that incidentally contains source code, whereas the idea of valuable comments nowadays is closer to highlighting concerns or explaining functionality that isn't evident or easy to read in the code itself. Or in other words; this sounds like a good idea! I wonder if it would help decrease the incidence of people ignoring and not updating comments though, as a developer's focus is often primarily on correcting the code and thus even with bolding the comments may end up falling into the same trap as banner blindness[1]. [1] https://en.wikipedia.org/wiki/Banner_blindness https://en.wikipedia.org/wiki/Banner_blindness