GoodVsBadComments

// Bad
if (user.authFlag() == AUTHORISED) {
  // Code
}

// Good
if (user.isLoggedIn()) {
  // Code
}

// Bad
/**
 *
 * Returns the meta keywords of the article
 *
 * @return a list of keywords
 */
public List<String> getMetaKeywords() {

    return document.getMetaKeywords();

}

// Good
public List<String> getMetaKeywords() {

    return document.getMetaKeywords();

}