ESQL: Update text formats documentation

[ivancea]

Spec docs update for the ESQL format parameter. Text formats result in missing metadata in the response body.

Main docs change: elastic/docs-content#2307

[github-actions]

Following you can find the validation changes against the target branch for the APIs.

No changes detected.

You can validate these APIs yourself by using the make validate target.

[nik9000]

Looks right to me though I don't know this infrastructure well enough to approve it.

[bpintea]

LGTM

[leemthompo]

Looks right to me though I don't know this infrastructure well enough to approve it.

@nik9000 @ivancea Just an FYI— I've got a PR for a first draft of contribution guidance for the API docs, included in the Elasticsearch quickstart is a way to preview the docs changes. Here's a link to the overview of those new pages:

elastic/docs-content#2229 (comment)

Let me know if that's helpful in any way, the plan is to merge that guide and then start working with devs to use that to plug some gaps in the new API docs. Will be using that feedback to iterate and improve the guidance over time. :)

[github-actions]

The backport to 8.19 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-8.19 8.19
# Navigate to the new working tree
cd .worktrees/backport-8.19
# Create a new branch
git switch --create backport-5054-to-8.19
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 a04b8725d5d74c9881b4ed7c579c15c42537791c
# Push it to GitHub
git push --set-upstream origin backport-5054-to-8.19
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-8.19

Then, create a pull request where the base branch is 8.19 and the compare/head branch is backport-5054-to-8.19.

[github-actions]

The backport to 9.0 failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-9.0 9.0
# Navigate to the new working tree
cd .worktrees/backport-9.0
# Create a new branch
git switch --create backport-5054-to-9.0
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 a04b8725d5d74c9881b4ed7c579c15c42537791c
# Push it to GitHub
git push --set-upstream origin backport-5054-to-9.0
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-9.0

Then, create a pull request where the base branch is 9.0 and the compare/head branch is backport-5054-to-9.0.