JavaDoc for methods

If you find it hard to write JavaDoc for your method, it’s a sign that you should rethink what your method does. Most likely your method is doing way too many things and you should break it into multiple methods.