Reading “Theory building and software development”, with a point on software documentation that I think needs exploring:

www.baldurbjarnason.com/2022/theo…

Most internal documentation only begins to make sense to a developer after they’ve developed an internal mental model of how it all hangs together. Most code documentation becomes useful after you have built the theory in your mind, not before. It operates as a mnemonic for what you already know, not as a tool for learning.