[docs] Add documentation for JinaAI service

[JoanFM]

Documentation piece referencing #118652

[github-actions]

Documentation preview:

• ✨ Changed pages

[leemthompo]

@elasticmachine test this

[leemthompo]

run docs-build

[lcawl]

Hi! Just a drive by reminder to make the same doc changes in https://github.com/elastic/elasticsearch-specification/tree/main/specification/inference, since we'll be retiring these manually-maintained asciidoc files soon.

[JoanFM]

Hey @lcawl , is there an example available?

[lcawl]

Hey @lcawl , is there an example available?

There's info in https://github.com/elastic/elasticsearch-specification/blob/main/docs/doc-comments-guide.md
Basically just the addition of comments to the specification so that when the make transform-to-openapi command runs, there's good descriptions in the output. The resulting OpenAPI files are published here: https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference

We're in the process of moving the examples from the old asciidoc pages so we can retire them completely.

[leemthompo]

@JoanFM you have added the docs to the git tree, but haven't included the asciidoc file in the inference API index page so the build system isn't finding it :)

[JoanFM]

@JoanFM you have added the docs to the git tree, but haven't included the asciidoc file in the inference API index page so the build system isn't finding it :)

Done, thanks!

[leemthompo]

@JoanFM It looks like your subsequent commits aren't triggering CI

You can use the comments I added earlier to launch them:

@elasticmachine test this

and

run docs-build

This is a good example of where building the docs locally would shorten feedback cycles and save some iteration time :)

[JoanFM]

@elasticmachine test this

[JoanFM]

run docs-build

[leemthompo]

@elasticmachine test this

[leemthompo]

run docs-build

[JoanFM]

@elasticmachine test this

[JoanFM]

run docs-build

[leemthompo]

@JoanFM you have multiple example snippets that need to be skipped

[leemthompo]

@elasticmachine test this

[leemthompo]

run docs-build

[leemthompo]

@JoanFM normally CI runs on every commit, I think we hit an edge case here because the file wasn't included initially 😄. It's usually not as painful a process as this (I promise), but again, good argument for testing locally.

[leemthompo]

@elasticmachine test this

[leemthompo]

run docs-build

[leemthompo]

Few suggestions, once addressed we should be able to run docs checks one last time 😅

[JoanFM]

Hey @leemthompo ,

changes applied

[elasticsearchmachine]

Pinging @elastic/ml-core (Team:ML)

[elasticsearchmachine]

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

[leemthompo]

@elasticmachine test this

[leemthompo]

run docs-build

[leemthompo]

LGTM! Thanks for your patience with the iterations, CI can be a bit of pain when you're an external contributor. ❤️

[davidkyle]

Hi! Just a drive by reminder to make the same doc changes in https://github.com/elastic/elasticsearch-specification/tree/main/specification/inference, since we'll be retiring these manually-maintained asciidoc files soon.

@JoanFM I've opened #118943 to track this and assigned it to one of the ML writers. He will take care of it once he returns from PTO.

And thanks for the PR ❤️