Skip to content

Conversation

@mridula-s109
Copy link
Contributor

@mridula-s109 mridula-s109 commented Oct 29, 2025

Improving the semantic text update documentation.

@mridula-s109 mridula-s109 changed the title semantic_text docs update for update operation restriction [Docs] Improve semantic_text updates documentation organization Oct 29, 2025
@mridula-s109 mridula-s109 self-assigned this Oct 29, 2025
@mridula-s109 mridula-s109 requested review from a team and leemthompo October 29, 2025 14:13
@mridula-s109 mridula-s109 added >docs General docs changes >non-issue :Search Relevance/Search Catch all for Search Relevance labels Oct 29, 2025
@mridula-s109 mridula-s109 marked this pull request as ready for review October 29, 2025 14:14
@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch labels Oct 29, 2025
@elasticsearchmachine
Copy link
Collaborator

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

@elasticsearchmachine
Copy link
Collaborator

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

@github-actions
Copy link
Contributor

github-actions bot commented Oct 29, 2025

🔍 Preview links for changed docs

@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?

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 @mridula-s109 couple of suggestions for your consideration, looking at the preview

@mridula-s109
Copy link
Contributor Author

Thanks @mridula-s109 couple of suggestions for your consideration, looking at the preview

Thanks @leemthompo, i have applied the suggestions for more clarity.

@mridula-s109 mridula-s109 enabled auto-merge (squash) October 29, 2025 14:51
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 @mridula-s109!

@mridula-s109 mridula-s109 merged commit b79ed62 into elastic:main Oct 29, 2025
11 checks passed
leemthompo added a commit that referenced this pull request Oct 29, 2025
while reviewing #137340, I noticed this section was a little messy

refactored to use definition lists
shmuelhanoch pushed a commit to shmuelhanoch/elasticsearch that referenced this pull request Oct 29, 2025
…tic#137340)

* Move script update restrictions section for consistency

* Update docs/reference/elasticsearch/mapping-reference/semantic-text.md

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

* Update docs/reference/elasticsearch/mapping-reference/semantic-text.md

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

* Update docs/reference/elasticsearch/mapping-reference/semantic-text.md

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

---------

Co-authored-by: Liam Thompson <[email protected]>
leemthompo added a commit that referenced this pull request Oct 30, 2025
* [Docd] Update semantic_text update instructions for clarity

while reviewing #137340, I noticed this section was a little messy

refactored to use definition lists

* Clarify instructions on preserving embeddings
chrisparrinello pushed a commit to chrisparrinello/elasticsearch that referenced this pull request Nov 3, 2025
…tic#137340)

* Move script update restrictions section for consistency

* Update docs/reference/elasticsearch/mapping-reference/semantic-text.md

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

* Update docs/reference/elasticsearch/mapping-reference/semantic-text.md

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

* Update docs/reference/elasticsearch/mapping-reference/semantic-text.md

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

---------

Co-authored-by: Liam Thompson <[email protected]>
chrisparrinello pushed a commit to chrisparrinello/elasticsearch that referenced this pull request Nov 3, 2025
…7345)

* [Docd] Update semantic_text update instructions for clarity

while reviewing elastic#137340, I noticed this section was a little messy

refactored to use definition lists

* Clarify instructions on preserving embeddings
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes >non-issue :Search Relevance/Search Catch all for Search Relevance Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch v9.3.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants