I think that more documentation needs to give context about design decisions/principles and why they were made. And hopefully the software is sticking to some p

I think that more documentation needs to give context about design decisions/principles and why they were made. And hopefully the software is sticking to some principles. If you can learn a small number of orthogonal principles, you can predict the behavior of the software without consulting the documentation, ideally