Skip to content

Conversation

@leemthompo
Copy link
Contributor

@leemthompo leemthompo commented Oct 29, 2025

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

refactored to use definition lists
@elasticsearchmachine elasticsearchmachine added v9.3.0 needs:triage Requires assignment of a team area label labels Oct 29, 2025
@leemthompo leemthompo self-assigned this Oct 29, 2025
@leemthompo leemthompo added >docs General docs changes :Search Relevance/Search Catch all for Search Relevance labels Oct 29, 2025
@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch and removed needs:triage Requires assignment of a team area label 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)

@leemthompo leemthompo changed the title [Docs] Update semantic_text update instructions for clarity [Docs] Edit semantic_text update instructions for clarity Oct 29, 2025
@github-actions
Copy link
Contributor

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

@mridula-s109
Copy link
Contributor

LGTM! Excellent eye for detail.

@leemthompo leemthompo merged commit 1caa6e3 into main Oct 30, 2025
12 checks passed
@leemthompo leemthompo deleted the leemthompo-patch-6 branch October 30, 2025 10:54
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 :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.

4 participants