diff --git a/rest-api-spec/api/cluster.health.json b/rest-api-spec/api/cluster.health.json
index 73e2932c9b8..8e6b049ad6e 100644
--- a/rest-api-spec/api/cluster.health.json
+++ b/rest-api-spec/api/cluster.health.json
@@ -8,7 +8,7 @@
       "parts": {
         "index": {
           "type" : "string",
-          "description" : "Limit the health information to specific index"
+          "description" : "Limit the information returned to a specific index"
         }
       },
       "params": {
@@ -24,7 +24,7 @@
         },
         "master_timeout": {
           "type" : "time",
-          "description" : "Explicit operation timeout for master node"
+          "description" : "Explicit operation timeout for connection to master node"
         },
         "timeout": {
           "type" : "time",
@@ -32,15 +32,15 @@
         },
         "wait_for_active_shards": {
           "type" : "number",
-          "description" : "Wait until specified number of shards is active"
+          "description" : "Wait until the specified number of shards is active"
         },
         "wait_for_nodes": {
           "type" : "number",
-          "description" : "Wait until specified number of nodes is available"
+          "description" : "Wait until the specified number of nodes is available"
         },
         "wait_for_relocating_shards": {
           "type" : "number",
-          "description" : "Wait until specified number of relocating shards is finished"
+          "description" : "Wait until the specified number of relocating shards is finished"
         },
         "wait_for_status": {
           "type" : "enum",