Как мне документировать параметр «говорит»?

Question

Не могу решить проблему: \ Как мне документировать второй параметр "говорит"?Потому что SonarQube спрашивает меня об этом снова и снова.

public class Dogs {

    private static final org.slf4j.Logger LOGGER = LoggerFactory.getLogger(Dogs.class);
    private final String                  name;
    private final String                  says;

    /**
     * The Dogs class.
     *
     * @param name
     *            says. // here the problem
     *
     */
    public Dogs(final String name, final String says) {
        this.name = name;
        this.says = says;
    }

}  

Answer 1

Вы должны добавить @param перед именем параметра, например:

/**
 * The Dogs class.
 *
 * @param name explain what is it ! 
 * @param says explain what is it !
 *
 */
public Dogs(final String name, final String says) {
    this.name = name;
    this.says = says;
}