Skip to content

Conversation

@charlotte-hoblik
Copy link
Contributor

@charlotte-hoblik charlotte-hoblik commented Nov 24, 2025

This PR updates the docs to address missing links between longform REST API examples and the API docs.

Connected to: https://github.com/elastic/docs-content-internal/issues/441
Connected PR: elastic/elasticsearch-specification#5857

@github-actions
Copy link
Contributor

ℹ️ Important: Docs version tagging

👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version.

We use applies_to tags to mark version-specific features and changes.

Expand for a quick overview

When to use applies_to tags:

✅ At the page level to indicate which products/deployments the content applies to (mandatory)
✅ When features change state (e.g. preview, ga) in a specific version
✅ When availability differs across deployments and environments

What NOT to do:

❌ Don't remove or replace information that applies to an older version
❌ Don't add new information that applies to a specific version without an applies_to tag
❌ Don't forget that applies_to tags can be used at the page, section, and inline level

🤔 Need help?

@charlotte-hoblik charlotte-hoblik marked this pull request as ready for review December 18, 2025 15:48
@elasticsearchmachine elasticsearchmachine added the needs:triage Requires assignment of a team area label label Dec 18, 2025
@charlotte-hoblik charlotte-hoblik added >docs General docs changes Team:Docs Meta label for docs team documentation v9.0.0 v9.1.0 v9.2.0 and removed needs:triage Requires assignment of a team area label v9.4.0 labels Dec 19, 2025
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/core-docs (Team:Docs)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes documentation Team:Docs Meta label for docs team v9.0.0 v9.1.0 v9.2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants