From 1e5295cec76864c7130948e37262ab2a7908ea5d Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Fri, 9 Aug 2019 09:13:29 -0400
Subject: [PATCH] [DOCS] Reformats cat repositories API

---
 docs/reference/cat/repositories.asciidoc | 35 ++++++++++++++++++++----
 1 file changed, 30 insertions(+), 5 deletions(-)

diff --git a/docs/reference/cat/repositories.asciidoc b/docs/reference/cat/repositories.asciidoc
index a0a4263aa473b..1f4ed6a0d4973 100644
--- a/docs/reference/cat/repositories.asciidoc
+++ b/docs/reference/cat/repositories.asciidoc
@@ -1,8 +1,35 @@
 [[cat-repositories]]
 === cat repositories
 
-The `repositories` command shows the snapshot repositories registered in the
-cluster. For example:
+Returns the <<snapshots-repositories,snapshot repositories>> for a cluster.
+
+
+[[cat-repositories-api-request]]
+==== {api-request-title}
+
+`GET /_cat/repositories`
+
+
+[[cat-repositories-query-params]]
+==== {api-query-parms-title}
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=http-format]
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-h]
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
+
+include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-v]
+
+
+[[cat-repositories-api-example]]
+==== {api-examples-title}
 
 [source,js]
 --------------------------------------------------
@@ -11,7 +38,7 @@ GET /_cat/repositories?v
 // CONSOLE
 // TEST[s/^/PUT \/_snapshot\/repo1\n{"type": "fs", "settings": {"location": "repo\/1"}}\n/]
 
-might looks like:
+The API returns the following response:
 
 [source,txt]
 --------------------------------------------------
@@ -20,5 +47,3 @@ repo1   fs
 repo2   s3
 --------------------------------------------------
 // TESTRESPONSE[s/\nrepo2   s3// non_json]
-
-We can quickly see which repositories are registered and their type.