Sorry for being so opinionated, I just think having common coding standards, using best practices, educate junior developers on design and architectural patterns used, and in general improving code quality ,simplifying code, refactoring, continuous training of developers, and many more will produce a code base that is easy to understand and maintain. You will often hear that commenting code is a code smell. imagine if you took a photograph and you also had to give a text of what is in the photograph, probably you should work on your photography skills, i can come up with 1000 metaphors the idea is that is you need to describe what is happening probably you should focus on improving the code quality instead of having comments that must be maintained. If you take a look at some popular Github projects you will not find comments inside the classes and methods.