Nice descriptions, but you'll want to have some ```@param``` and ```@return``` as well for the javadoc (same for the other methods)