You're still missing the initial sentence here meant to describe the method. You've just got the two parameters explained :-) So part of the first param here probably should be in its own sentence at the start of the javadoc.