-
Notifications
You must be signed in to change notification settings - Fork 121
Questions you may ask
Michel Jung edited this page May 20, 2016
·
5 revisions
Because comments are often deodorant for smelly code: https://sourcemaking.com/refactoring/smells/comments
If you have an understanding of what the software is about and what patterns and frameworks are used, a class' responsibility very often becomes clear by its name alone - no JavaDoc needed. If you have an understanding of a class' responsibilities, the purpose of its methods often become very clear by their names alone - no JavaDoc needed either.
You should not have to read JavaDocs to gain understanding of a software - architecture overviews and an understanding of the domain (basically the game) are much more efficient.