Skip to content

Conversation

@alex-spies
Copy link
Contributor

aggregate_metric_double and dense_vector are a bit special on 9.2.0, but not anymore on 9.2.1. Let's make that clear and let's add their corresponding type conversion functions (to_...) to our public docs.

aggregate_metric_double and dense_vector
@alex-spies alex-spies added >docs General docs changes :Analytics/ES|QL AKA ESQL :Search Relevance/ES|QL Search functionality in ES|QL :StorageEngine/ES|QL Timeseries / metrics / logsdb capabilities in ES|QL v9.3.0 labels Nov 7, 2025
@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) Team:StorageEngine Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch labels Nov 7, 2025
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-analytical-engine (Team:Analytics)

@elasticsearchmachine
Copy link
Collaborator

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

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-storage-engine (Team:StorageEngine)

@elasticsearchmachine
Copy link
Collaborator

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

@github-actions
Copy link
Contributor

github-actions bot commented Nov 7, 2025

@github-actions
Copy link
Contributor

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

Copy link
Contributor

@kkrik-es kkrik-es left a comment

Choose a reason for hiding this comment

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

Thanks Alex, @limotova fyi.

@alex-spies
Copy link
Contributor Author

@limotova , I noticed that our generated function docs don't mention the preview status of TO_AGGREGATE_METRIC_DOUBLE, I think we need to follow up on this:
image
It should probably look similar to this:
image

@alex-spies
Copy link
Contributor Author

@carlosdelest , it looks like our generated function doc for TO_DENSE_VECTOR doesn't know that this is still in preview:
image

@leemthompo
Copy link
Contributor

leemthompo commented Nov 7, 2025

@carlosdelest @limotova

On the previews refer to the README for details.

EDIT: I threw up a PR: #137740

Grouped dense_vector and aggregate_metric_double limitations under single bullet with sub-bullets
Added subheading "Partial support in 9.2.0"
Fixed broken elasticsearch:// cross-repo links to /reference/ format
Converted multi-index paragraph to bullet point
Wrapped explanation in note block with bulleted examples
@leemthompo
Copy link
Contributor

@kkrik-es this looks shippable to me now, I'll let you merge if you're happy :)

Copy link
Member

@carlosdelest carlosdelest left a comment

Choose a reason for hiding this comment

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

LGTM, thanks @alex-spies !

Copy link
Contributor

@limotova limotova left a comment

Choose a reason for hiding this comment

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

Thank you!

@leemthompo leemthompo merged commit eee9aa3 into elastic:main Nov 10, 2025
11 checks passed
Kubik42 pushed a commit to Kubik42/elasticsearch that referenced this pull request Nov 10, 2025
* Update docs for new types

aggregate_metric_double and dense_vector

* Fix typos

* Try to fix applies_to markers

* Fixes

* Mark conversion functions as preview

* Use consistent links

* Mention TO_DENSE_VECTOR

* Refactor 9.2.0 type limitations and fix cross-repo links

Grouped dense_vector and aggregate_metric_double limitations under single bullet with sub-bullets
Added subheading "Partial support in 9.2.0"
Fixed broken elasticsearch:// cross-repo links to /reference/ format
Converted multi-index paragraph to bullet point
Wrapped explanation in note block with bulleted examples

---------

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

:Analytics/ES|QL AKA ESQL >docs General docs changes :Search Relevance/ES|QL Search functionality in ES|QL :StorageEngine/ES|QL Timeseries / metrics / logsdb capabilities in ES|QL Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch Team:StorageEngine v9.3.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants