diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/ha/HAState.java b/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/ha/HAState.java
index f30071018f6..f56974864d6 100644
--- a/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/ha/HAState.java
+++ b/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/ha/HAState.java
@@ -34,7 +34,7 @@ abstract public class HAState {
 
   /**
    * Constructor
-   * @param name Name of the state.
+   * @param state HA service state.
    */
   public HAState(HAServiceState state) {
     this.state = state;
@@ -48,8 +48,8 @@ abstract public class HAState {
   }
 
   /**
-   * Internal method to transition the state of a given namenode to a new state.
-   * @param nn Namenode
+   * Internal method to move from the existing state to a new state.
+   * @param context HA context
    * @param s new state
    * @throws ServiceFailedException on failure to transition to new state.
    */