diff --git a/src/java/org/apache/poi/hssf/usermodel/HSSFComment.java b/src/java/org/apache/poi/hssf/usermodel/HSSFComment.java
index 0013bd1..593f362 100644
--- a/src/java/org/apache/poi/hssf/usermodel/HSSFComment.java
+++ b/src/java/org/apache/poi/hssf/usermodel/HSSFComment.java
@@ -143,7 +143,7 @@ public class HSSFComment extends HSSFTextbox implements Comment {
     }
 
     /**
-     * Returns whether this comment is visible.
+     * Sets whether this comment is visible.
      *
      * @param visible <code>true</code> if the comment is visible, <code>false</code> otherwise
      */
@@ -154,7 +154,7 @@ public class HSSFComment extends HSSFTextbox implements Comment {
     }
 
     /**
-     * Sets whether this comment is visible.
+     * Returns whether this comment is visible.
      *
      * @return <code>true</code> if the comment is visible, <code>false</code> otherwise
      */
diff --git a/src/java/org/apache/poi/ss/usermodel/Comment.java b/src/java/org/apache/poi/ss/usermodel/Comment.java
index 311b39f..c39040c 100644
--- a/src/java/org/apache/poi/ss/usermodel/Comment.java
+++ b/src/java/org/apache/poi/ss/usermodel/Comment.java
@@ -22,14 +22,14 @@ import org.apache.poi.ss.util.CellAddress;
 public interface Comment {
 
     /**
-     * Returns whether this comment is visible.
+     * Sets whether this comment is visible.
      *
      * @param visible <code>true</code> if the comment is visible, <code>false</code> otherwise
      */
     void setVisible(boolean visible);
 
     /**
-     * Sets whether this comment is visible.
+     * Returns whether this comment is visible.
      *
      * @return <code>true</code> if the comment is visible, <code>false</code> otherwise
      */
diff --git a/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFComment.java b/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFComment.java
index 7140e5b..6e69fa9 100644
--- a/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFComment.java
+++ b/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFComment.java
@@ -102,7 +102,9 @@ public class XSSFComment implements Comment {
     }
 
     /**
-     * @return whether the comment is visible
+     * Returns whether this comment is visible.
+     *
+     * @return <code>true</code> if the comment is visible, <code>false</code> otherwise
      */
     @Override
     public boolean isVisible() {
@@ -115,7 +117,9 @@ public class XSSFComment implements Comment {
     }
 
     /**
-     * @param visible whether the comment is visible
+     * Sets whether this comment is visible.
+     *
+     * @param visible <code>true</code> if the comment is visible, <code>false</code> otherwise
      */
     @Override
     public void setVisible(boolean visible) {