Are you including javadoc param tags with empty descriptions as placeholders to fill in later? I'm of course in favor of param and return tags when there is information not obvious from parameter names or the method comment, but from my point of view blank tags just make the Javadoc longer. I suppose this is a matter of style, but I prefer less verbosity when possible. If we agree to only add these tags when needed, I'll amend the coding style guidelines.