Skip to content

Conversation

john-wagster
Copy link
Contributor

No description provided.

@john-wagster john-wagster added >docs General docs changes :Search Relevance/Vectors Vector search v9.2.0 labels Sep 3, 2025
@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch labels Sep 3, 2025
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-search-relevance (Team:Search Relevance)

@elasticsearchmachine
Copy link
Collaborator

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

@john-wagster
Copy link
Contributor Author

waiting on feature flag removal for bbq_disk

@github-actions
Copy link
Contributor

github-actions bot commented Sep 3, 2025

@github-actions
Copy link
Contributor

github-actions bot commented Sep 3, 2025

ℹ️ 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?

@benwtrent
Copy link
Member

we should wait until we remove the feature flag. But good to get the PR open now :).

We should likely have a section "When to use this..." in one of our pages.

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

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

Thanks for using the version tags @john-wagster 🏅 👍

Just couple suggestions to use inline, rather than section-level tags :)

@john-wagster
Copy link
Contributor Author

closed in favor of #135299

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

Labels

>docs General docs changes :Search Relevance/Vectors Vector search Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch v9.2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants