From 6f392cf5b9159beb197aaeb23c51a9010238b14f Mon Sep 17 00:00:00 2001
From: Jake Landis <jake.landis@elastic.co>
Date: Mon, 27 Apr 2020 10:08:09 -0500
Subject: [PATCH] [7.x] json spec - add description for searchable snapshots
 (#55746) (#55809)

---
 x-pack/plugin/build.gradle                                    | 4 ----
 .../rest-api-spec/api/searchable_snapshots.clear_cache.json   | 3 ++-
 .../rest-api-spec/api/searchable_snapshots.mount.json         | 3 ++-
 .../api/searchable_snapshots.repository_stats.json            | 3 ++-
 .../rest-api-spec/api/searchable_snapshots.stats.json         | 3 ++-
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/build.gradle b/x-pack/plugin/build.gradle
index 4fc22a402ff..2312de4d2e7 100644
--- a/x-pack/plugin/build.gradle
+++ b/x-pack/plugin/build.gradle
@@ -157,10 +157,6 @@ testClusters.integTest {
 }
 
 validateRestSpec {
-  ignore 'searchable_snapshots.mount.json'
-  ignore 'searchable_snapshots.clear_cache.json'
-  ignore 'searchable_snapshots.stats.json'
-  ignore 'searchable_snapshots.repository_stats.json'
   ignore 'autoscaling.delete_autoscaling_policy.json'
   ignore 'autoscaling.get_autoscaling_policy.json'
   ignore 'autoscaling.put_autoscaling_policy.json'
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.clear_cache.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.clear_cache.json
index 216cedd93ea..9dc9f424bea 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.clear_cache.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.clear_cache.json
@@ -1,7 +1,8 @@
 {
   "searchable_snapshots.clear_cache": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-api-clear-cache.html"
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-api-clear-cache.html",
+      "description" : "Clear the cache of searchable snapshots."
     },
     "stability": "experimental",
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.mount.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.mount.json
index 995944cf8f9..c992384a385 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.mount.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.mount.json
@@ -1,7 +1,8 @@
 {
   "searchable_snapshots.mount": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-api-mount-snapshot"
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-api-mount-snapshot.html",
+      "description": "Mount a snapshot as a searchable index."
     },
     "stability": "experimental",
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.repository_stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.repository_stats.json
index 9f34c76691f..a04bd0dbab6 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.repository_stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.repository_stats.json
@@ -1,7 +1,8 @@
 {
   "searchable_snapshots.repository_stats": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/searchable-snapshots-repository-stats.html"
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-repository-stats.html",
+      "description": "Retrieve usage statistics about a snapshot repository."
     },
     "stability": "experimental",
     "url": {
diff --git a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.stats.json b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.stats.json
index b34fd7084b1..b75903a45cd 100644
--- a/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.stats.json
+++ b/x-pack/plugin/src/test/resources/rest-api-spec/api/searchable_snapshots.stats.json
@@ -1,7 +1,8 @@
 {
   "searchable_snapshots.stats": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-api-stats.html"
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/searchable-snapshots-api-stats.html",
+      "description": "Retrieve various statistics about searchable snapshots."
     },
     "stability": "experimental",
     "url": {