DOC-13120: Convert Search REST APIs to OpenAPI (#165)

* Add Search Gradle files
* Import Search specs
* Add deprecation notice snippets
* Add header attributes
* Add CSS passthroughs
* Add security partials
* Externalize examples
* Migrate examples from docs-server
* Improve parameter descriptions and examples
* Move nsstats for index into the Stats spec
* Update description of partition APIs
* Standardize API versions
* Explain parameters in examples
* Build output docs

Author: simon-dew

build.gradle

@@ -29,6 +29,12 @@ defaultTasks 'admin:openApiGenerate',
              'eventing:openApiGenerate',
              'functions:openApiGenerate',
              'indexes:openApiGenerate',
+             'search-index:openApiGenerate',
+             'search-nodes:openApiGenerate',
+             'search-advanced:openApiGenerate',
+             'search-stats:openApiGenerate',
+             'search-query:openApiGenerate',
+             'search-manage:openApiGenerate',
              'analytics-admin:openApiGenerate',
              'analytics-config:openApiGenerate',
              'analytics-library:openApiGenerate',

docs/modules/analytics-rest-admin/pages/index.adoc

@@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access.
 a| *host*
 a| [markdown]
 --
-The host name or IP address of a node running the Analytics service.
+The host name or IP address of a node running the Analytics Service.
 --
 
 [%hardbreaks]
@@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service.
 a| *port*
 a| [markdown]
 --
-The Analytics service REST port. Use `18095` for secure access.
+The Analytics Service REST port. Use `18095` for secure access.
 --
 
 [%hardbreaks]

docs/modules/analytics-rest-admin/partials/security/document-begin.adoc

@@ -1,2 +1,2 @@
 The Analytics Administration REST APIs support HTTP basic authentication.
-Credentials can be passed via HTTP headers.
+Pass your credentials through HTTP headers.

docs/modules/analytics-rest-admin/partials/security/document-end.adoc

@@ -1 +1 @@
-Refer to xref:learn:security/roles.adoc[] for more details.
+For more information, see xref:learn:security/roles.adoc[].

docs/modules/analytics-rest-config/pages/index.adoc

@@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access.
 a| *host*
 a| [markdown]
 --
-The host name or IP address of a node running the Analytics service.
+The host name or IP address of a node running the Analytics Service.
 --
 
 [%hardbreaks]
@@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service.
 a| *port*
 a| [markdown]
 --
-The Analytics service REST port. Use `18095` for secure access.
+The Analytics Service REST port. Use `18095` for secure access.
 --
 
 [%hardbreaks]

docs/modules/analytics-rest-config/partials/security/document-begin.adoc

@@ -1,2 +1,2 @@
 The Analytics Configuration REST API supports HTTP basic authentication.
-Credentials can be passed via HTTP headers.
+Pass your credentials through HTTP headers.

docs/modules/analytics-rest-config/partials/security/document-end.adoc

@@ -1 +1 @@
-Refer to xref:learn:security/roles.adoc[] for more details.
+For more information, see xref:learn:security/roles.adoc[].

docs/modules/analytics-rest-library/pages/index.adoc

@@ -65,7 +65,7 @@ The URL scheme. Use `https` for secure access.
 a| *host*
 a| [markdown]
 --
-The host name or IP address of a node running the Analytics service.
+The host name or IP address of a node running the Analytics Service.
 --
 
 [%hardbreaks]
@@ -76,7 +76,7 @@ The host name or IP address of a node running the Analytics service.
 a| *port*
 a| [markdown]
 --
-The Analytics service REST port. Use `18095` for secure access.
+The Analytics Service REST port. Use `18095` for secure access.
 --
 
 [%hardbreaks]

docs/modules/analytics-rest-library/partials/security/document-begin.adoc

@@ -1,2 +1,2 @@
 The Analytics Library REST API supports HTTP basic authentication.
-Credentials can be passed via HTTP headers.
+Pass your credentials through HTTP headers.

docs/modules/analytics-rest-library/partials/security/document-end.adoc

@@ -1 +1 @@
-Refer to xref:learn:security/roles.adoc[] for more details.
+For more information, see xref:learn:security/roles.adoc[].