I agree.
This is something that I tried to do with my best project. [1] Only time will tell if I succeeded because it's really hard to document a mental model; it's like trying to explain to yourself what water is when you're a fish. [2]
[1]: https://git.gavinhoward.com/gavin/bc/src/branch/master/manua...