Java by Comparison
For over six years, we've taught Java at University and reviewed thousands of lines of Java code written by young students. In our code reviews, we've covered in detail why some code is bad, how to write it in a better way and why the better way is really better. Over time, we've realized that we told every new generation of students basically the same things. And from those student reviews, we've published our book Java by Comparison.
Please note, however, that although we've put every comparison from the book below like a table of contents, the actual contents are only available in the actual book.
Chapter 1: Start Cleaning Up
Chapter 2: Level Up Your Code Style
Chapter 3: Use Comments Wisely
- Remove Superfluous Comments
- Remove Commented-Out Code
- Replace Comments with Constants
- Replace Comments with Utility Methods
- Document Implementation Decisions
- Document Using Examples
- Structure JavaDoc of Packages
- Structure JavaDoc of Classes and Interfaces
- Structure JavaDoc of Methods
- Structure JavaDoc of Constructors