Skip to content

[DOCS] Note doc links should be live in REST API JSON specs #53871

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Mar 23, 2020
Merged

[DOCS] Note doc links should be live in REST API JSON specs #53871

merged 1 commit into from
Mar 23, 2020

Conversation

jrodewig
Copy link
Contributor

Downstream Elasticsearch clients, such as the Elaticsearch-JS client,
use the documentation links in our REST API JSON specifications to
create their docs.

Using a broken link or linking to yet-to-be-created doc pages can
break the docs build for these clients.

This PR adds a related note to the README for the REST API JSON Specs.

Downstream Elasticsearch clients, such as the Elaticsearch-JS client,
use the documentation links in our REST API JSON specifications to
create their docs.

Using a broken link or linking to yet-to-be-created doc pages can
break the docs build for these clients.

This PR adds a related note to the README for the REST API JSON Specs.
@jrodewig jrodewig added >docs General docs changes :Docs labels Mar 20, 2020
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-docs (>docs)

Copy link
Contributor

@szabosteve szabosteve left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thanks for making this change @jrodewig!

@jrodewig jrodewig merged commit 1df7382 into elastic:master Mar 23, 2020
@jrodewig jrodewig deleted the docs__json-api-links branch March 23, 2020 11:36
jrodewig added a commit that referenced this pull request Mar 23, 2020
Downstream Elasticsearch clients, such as the Elaticsearch-JS client,
use the documentation links in our REST API JSON specifications to
create their docs.

Using a broken link or linking to yet-to-be-created doc pages can
break the docs build for these clients.

This PR adds a related note to the README for the REST API JSON Specs.
jrodewig added a commit that referenced this pull request Mar 23, 2020
Downstream Elasticsearch clients, such as the Elaticsearch-JS client,
use the documentation links in our REST API JSON specifications to
create their docs.

Using a broken link or linking to yet-to-be-created doc pages can
break the docs build for these clients.

This PR adds a related note to the README for the REST API JSON Specs.
jrodewig added a commit that referenced this pull request Mar 23, 2020
Downstream Elasticsearch clients, such as the Elaticsearch-JS client,
use the documentation links in our REST API JSON specifications to
create their docs.

Using a broken link or linking to yet-to-be-created doc pages can
break the docs build for these clients.

This PR adds a related note to the README for the REST API JSON Specs.
@jrodewig
Copy link
Contributor Author

Backport commits

master 1df7382
7.x 1d1e177
7.6 8ad4e7a
6.8 eece651

tlrx added a commit that referenced this pull request Apr 2, 2020
This commit adds basic documentation for the searchable snapshots 
REST APIs. The main motivations are to not break downstream 
projects (see #53871) and to provide a simple example of how to 
mount a snapshot.

It adds a new "Searchable Snapshots APIs" sub section in the REST 
APIs section. The "Mount Snapshot API" is the more complete 
documentation and provides an example of how to create a new 
index backed by a snapshot.

Those API are experimental and marked as such. I've not seen any 
mention of the license, except the [testenv="basic"] tags that I copied 
from other doc.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants