"This doesn't do what I thought it did" should have a strong connection to needing to rely on reading documentation made from comments. In some sense that form

"This doesn't do what I thought it did" should have a strong connection to needing to rely on reading documentation made from comments. In some sense that form of literate programming is about limiting the scope of each individual misunderstanding without eliminating any of the misunderstandings.