Skip to content

ES|QL: Add docs for FORK#130314

Merged
ioanatia merged 7 commits intoelastic:mainfrom
ioanatia:fork_docs
Jun 30, 2025
Merged

ES|QL: Add docs for FORK#130314
ioanatia merged 7 commits intoelastic:mainfrom
ioanatia:fork_docs

Conversation

@ioanatia
Copy link
Copy Markdown
Member

#121950

Does what is says.
Now that FORK is out of snapshot and in tech preview, we need to document the feature.

@ioanatia ioanatia added >docs General docs changes auto-backport Automatically create backport pull requests when merged :Search Relevance/Search Catch all for Search Relevance v9.1.0 Team:Search - Relevance The Search organization Search Relevance team labels Jun 30, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Jun 30, 2025

🔍 Preview links for changed docs:

🔔 The preview site may take up to 3 minutes to finish building. These links will become live once it completes.

@elasticsearchmachine elasticsearchmachine added Team:Docs Meta label for docs team Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch v9.2.0 and removed Team:Search - Relevance The Search organization Search Relevance team labels Jun 30, 2025
@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

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

@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

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

Copy link
Copy Markdown
Member

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

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

This looks good! I made a couple of comments earlier outside of a proper review, one of which should fix the broken build.

I have a few minor wording suggestions here, but otherwise I have 2 general remarks:

  • Maybe we could have a bit more "Why Use FORK?" information at the outset.
    • Explain when to use FORK (applying different processing logic to the same dataset)
    • Advantages over multiple separate queries or complex CASE statements
    • Common use cases
  • Add More Examples
    • Include comparison examples showing FORK vs alternatives

But that might be out of scope for initial release, so it could just be future food for thought :)

ioanatia and others added 3 commits June 30, 2025 14:47
…-commands.md

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
@ioanatia ioanatia requested a review from leemthompo June 30, 2025 12:52
Copy link
Copy Markdown
Member

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

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

I have just a few more suggestions to basically group related info (branch id, column handling, row ordering) in a more readable fashion. I'd still like to see a couple more illustrative examples but understand this might be good enough for now. :)

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
@ioanatia ioanatia mentioned this pull request Jun 30, 2025
23 tasks
…fork.md

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
@ioanatia ioanatia merged commit a239306 into elastic:main Jun 30, 2025
32 checks passed
@ioanatia ioanatia deleted the fork_docs branch June 30, 2025 18:04
@elasticsearchmachine
Copy link
Copy Markdown
Collaborator

💚 Backport successful

Status Branch Result
9.1

ioanatia added a commit to ioanatia/elasticsearch that referenced this pull request Jun 30, 2025
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
elasticsearchmachine pushed a commit that referenced this pull request Jun 30, 2025
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
mridula-s109 pushed a commit to mridula-s109/elasticsearch that referenced this pull request Jul 3, 2025
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-backport Automatically create backport pull requests when merged >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.1.0 v9.2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants