I think code should be written to maximize readability. But I also think there needs to be a maintained design doc that describes the abstractions at a high le

I think code should be written to maximize readability. But I also think there needs to be a maintained design doc that describes the abstractions at a high level and connects the design to the business terminology. Having a 10,000 foot view not only helps junior developers, it helps new people joining the project.