Skip to content

Conversation

nik9000
Copy link
Member

@nik9000 nik9000 commented Sep 19, 2025

Updates the docs for multivalued fields to make it clear that grouping puts the entire row in each group.

Relates to #134792

Updates the docs for multivalued fields to make it clear that grouping
puts the entire *row* in each group.

Relates to elastic#134792
@nik9000 nik9000 added >docs General docs changes :Analytics/ES|QL AKA ESQL v9.2.0 labels Sep 19, 2025
@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) labels Sep 19, 2025
@elasticsearchmachine
Copy link
Collaborator

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

@elasticsearchmachine
Copy link
Collaborator

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

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

@craigtaverner craigtaverner left a comment

Choose a reason for hiding this comment

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

LGTM

:::{include} ../examples/stats.csv-spec/multi-mv-group.md
:::

The input **ROW** is in all groups. The entire row. All the values. Even group
Copy link
Contributor

Choose a reason for hiding this comment

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

OK, so you are really emphasising this! Probably necessary, since it is far from obvious.

@craigtaverner craigtaverner added v9.1.5 v9.0.8 auto-backport Automatically create backport pull requests when merged labels Sep 30, 2025
@leemthompo
Copy link
Contributor

leemthompo commented Sep 30, 2025

@craigtaverner @nik9000 looking at the preview for this page raised a question in my mind:

is there any reason we can't use actual headings in these command references? For biggish pages like this one, we have no On this page orientation, because we just use bold text instead of actual headings.

It would help us break up the walls of examples into scannable subgroups too, for example.

Not to be tackled in this PR, of course, but might be a UX improvement I/we can follow up on. :)

@nik9000 nik9000 merged commit af1739b into elastic:main Sep 30, 2025
34 checks passed
@nik9000
Copy link
Member Author

nik9000 commented Sep 30, 2025

I don't see a reason why we can't make more headings.

@elasticsearchmachine
Copy link
Collaborator

💚 Backport successful

Status Branch Result
9.1
9.0

nik9000 added a commit to nik9000/elasticsearch that referenced this pull request Sep 30, 2025
Updates the docs for multivalued fields to make it clear that grouping
puts the entire *row* in each group.

Relates to elastic#134792

Co-authored-by: Craig Taverner <[email protected]>
nik9000 added a commit to nik9000/elasticsearch that referenced this pull request Sep 30, 2025
Updates the docs for multivalued fields to make it clear that grouping
puts the entire *row* in each group.

Relates to elastic#134792

Co-authored-by: Craig Taverner <[email protected]>
elasticsearchmachine pushed a commit that referenced this pull request Sep 30, 2025
Updates the docs for multivalued fields to make it clear that grouping
puts the entire *row* in each group.

Relates to #134792

Co-authored-by: Craig Taverner <[email protected]>
elasticsearchmachine pushed a commit that referenced this pull request Sep 30, 2025
Updates the docs for multivalued fields to make it clear that grouping
puts the entire *row* in each group.

Relates to #134792

Co-authored-by: Craig Taverner <[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 auto-backport Automatically create backport pull requests when merged >docs General docs changes Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) Team:Docs Meta label for docs team v9.0.8 v9.1.5 v9.2.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants