Skip to content

[ESQL] Cleanup commands docs#143058

Merged
leemthompo merged 8 commits intoelastic:mainfrom
leemthompo:esql-commands-docs-cleanup
Feb 27, 2026
Merged

[ESQL] Cleanup commands docs#143058
leemthompo merged 8 commits intoelastic:mainfrom
leemthompo:esql-commands-docs-cleanup

Conversation

@leemthompo
Copy link
Copy Markdown
Member

@leemthompo leemthompo commented Feb 25, 2026

closes https://github.com/elastic/docs-content-internal/issues/799

Summary

The STATS command page was recently improved as part of #133629. This PR applies the same treatment to all ES|QL command docs for consistency, with improved layout, scannability, and examples structure.

👁️ URL previews

@github-actions
Copy link
Copy Markdown
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?

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 26, 2026

@leemthompo leemthompo added >docs General docs changes Team:Docs Meta label for docs team :Analytics/ES|QL AKA ESQL labels Feb 26, 2026
@leemthompo leemthompo marked this pull request as ready for review February 26, 2026 09:35
@leemthompo leemthompo requested a review from a team as a code owner February 26, 2026 09:35
@elasticsearchmachine elasticsearchmachine added the Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) label Feb 26, 2026
@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

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

@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

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

@leemthompo leemthompo merged commit 89f194a into elastic:main Feb 27, 2026
12 checks passed
@leemthompo leemthompo deleted the esql-commands-docs-cleanup branch February 27, 2026 09:10
PeteGillinElastic pushed a commit to PeteGillinElastic/elasticsearch that referenced this pull request Feb 27, 2026
* wip

* update remaining commands

* fix links

* mention query directives on commands landing page

* clarify

* remove em dashes

* add tip about TS in FROM docs
szybia added a commit to szybia/elasticsearch that referenced this pull request Feb 27, 2026
…cations

* upstream/main: (35 commits)
  Create ARM bulk sqrI8 implementation (elastic#142461)
  Rework get-snapshots predicates (elastic#143161)
  Refactor downsampling fetchers and producers (elastic#140357)
  ESQL: Unmute test and add extra logging to generative test validation (elastic#143168)
  Fix metadata fields being nullified/loaded by unmapped_fields setting (elastic#143155)
  Determine remote cluster version (elastic#142494)
  Populate failure message for aborted clones (elastic#143206)
  Allow kibana_system role to read and manage logs streams (elastic#143053)
  Mute org.elasticsearch.xpack.esql.CsvIT test {csv-spec:eval.DocsLength} elastic#143224
  Mute org.elasticsearch.xpack.esql.CsvIT test {csv-spec:eval.DocsByteLength} elastic#143223
  Mute org.elasticsearch.xpack.esql.CsvIT test {csv-spec:docs.DocsBitLength} elastic#143222
  Fix FloatVectorScorerSupplier bulkScore bug (elastic#143211)
  ESQL: Add data node execution for external sources (elastic#143209)
  [ESQL] Cleanup commands docs (elastic#143058)
  [ML]Fix latest transforms disregarding updates when sort and sync fields are non-monotonic (elastic#142856)
  Mute org.elasticsearch.index.mapper.IpFieldMapperTests testSyntheticSourceInObject elastic#143212
  Tests: Fix StoreDirectoryMetricsIT (elastic#143084)
  ESQL: Add distribution strategy for external sources (elastic#143194)
  CSV IT spec (elastic#142585)
  Fix VectorScorerOSQBenchmark.score to read corrections properly (elastic#143137)
  ...
tballison pushed a commit to tballison/elasticsearch that referenced this pull request Mar 3, 2026
* wip

* update remaining commands

* fix links

* mention query directives on commands landing page

* clarify

* remove em dashes

* add tip about TS in FROM docs
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 Team:Analytics Meta label for analytical engine team (ESQL/Aggs/Geo) Team:Docs Meta label for docs team v9.4.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants