Skip to content

Conversation

@leemthompo
Copy link
Contributor

@leemthompo leemthompo commented Oct 20, 2025

Thanks to @theletterf (elastic/docs-builder#1615) we can now include pages from other repos in nav, which helps fight scattered-ness and makes other ESQL pages equally prominent

@leemthompo leemthompo self-assigned this Oct 20, 2025
@leemthompo leemthompo added >docs General docs changes Team:Docs Meta label for docs team labels Oct 20, 2025
@elasticsearchmachine
Copy link
Collaborator

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

@github-actions
Copy link
Contributor

github-actions bot commented Oct 20, 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?

@leemthompo leemthompo requested a review from a team October 20, 2025 16:04
Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

sure!

one comment because I can

Comment on lines 12 to 13
* [ES|QL for search](docs-content://solutions/search/esql-for-search.md): Learn how to use {{esql}} for search use cases using {{es}}.
* [ES|QL for security](docs-content://solutions/security/esql-for-security.md): Learn how to use {{esql}} for cybersecurity use cases. No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

would like to see these jazzed up with some hints at the use cases people might be solving 🤷 will help people to feel confident they're going to the right place

Copy link
Contributor Author

Choose a reason for hiding this comment

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

💯

52e6720

joey-jazz-hands

@leemthompo leemthompo merged commit f365e02 into elastic:main Oct 21, 2025
8 checks passed
chrisparrinello pushed a commit to chrisparrinello/elasticsearch that referenced this pull request Oct 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes Team:Docs Meta label for docs team v9.3.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants