Skip to content

Conversation

@mridula-s109
Copy link
Contributor

This PR adds a clarification in the linear top level normalizer.

Follow up from PR: #129693

@mridula-s109 mridula-s109 requested review from a team and leemthompo September 5, 2025 12:38
@mridula-s109 mridula-s109 self-assigned this Sep 5, 2025
@mridula-s109 mridula-s109 added >docs General docs changes Team:Docs Meta label for docs team :SearchOrg/Relevance Label for the Search (solution/org) Relevance team Team:Search - Relevance The Search organization Search Relevance team v9.2.0 labels Sep 5, 2025
@elasticsearchmachine
Copy link
Collaborator

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

@elasticsearchmachine
Copy link
Collaborator

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

@github-actions
Copy link
Contributor

github-actions bot commented Sep 5, 2025

🔍 Preview links for changed docs

@github-actions
Copy link
Contributor

github-actions bot commented Sep 5, 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?

@mridula-s109
Copy link
Contributor Author

mridula-s109 commented Sep 15, 2025

@leemthompo @dimitris-athanasiou can you please approve the finalised version or please let me know if any further changes are required?

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.

LGTM with a final tweak. I recommend always checking the URL preview to make sure that docs changes make sense for the reader, especially when using these inline applies_to tags which need to clearly target a specific section :)

@mridula-s109 mridula-s109 enabled auto-merge (squash) September 15, 2025 14:28
@mridula-s109 mridula-s109 merged commit b6f5141 into elastic:main Sep 15, 2025
11 checks passed
mridula-s109 added a commit to mridula-s109/elasticsearch that referenced this pull request Sep 17, 2025
* Improved changes to the doc

* Add back missing warning about avoiding 'none' normalizer with field grouping

* Move applies_to tag to specific behavior description to clarify version support

* cleaning it up

* cleaned up

* cleaned up

* Update linear-retriever.md

* Update docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md

Co-authored-by: Liam Thompson <[email protected]>

* Update docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md

Co-authored-by: Liam Thompson <[email protected]>

---------

Co-authored-by: Liam Thompson <[email protected]>
gmjehovich pushed a commit to gmjehovich/elasticsearch that referenced this pull request Sep 18, 2025
* Improved changes to the doc

* Add back missing warning about avoiding 'none' normalizer with field grouping

* Move applies_to tag to specific behavior description to clarify version support

* cleaning it up

* cleaned up

* cleaned up

* Update linear-retriever.md

* Update docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md

Co-authored-by: Liam Thompson <[email protected]>

* Update docs/reference/elasticsearch/rest-apis/retrievers/linear-retriever.md

Co-authored-by: Liam Thompson <[email protected]>

---------

Co-authored-by: Liam Thompson <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes :SearchOrg/Relevance Label for the Search (solution/org) Relevance team Team:Docs Meta label for docs team Team:Search - Relevance The Search organization Search Relevance team v9.2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants