Open dej611 opened 8 months ago
Pinging @elastic/es-analytics-geo (Team:Analytics)
We already automate the parameter types and the railroad diagrams. But we could probably generate even more of this stuff. I'm not sure we'd want to generate all of, but a lot more.
I do not think generate all of it makes sense, but at least the structured part as described in the issue content.
We already do that in Kibana and want to leverage the new SHOW FUNCTIONS
to use ES as source of truth for it.
Right now we generate two files and manually make another "main" file with the description and the name and description and an example. But I'll bet we could generate that "main" file and have it include hand written asciidoc files. That'd be pretty simple.
I've automated the generation of the signature, examples, and parameters. And a file that links them all together. Basically all of this. A human being has to manually merge the data in the docs and annotations and replace the hand maintained docs with the generated ones. I'm going to make a list to track them.
Pinging @elastic/es-analytical-engine (Team:Analytics)
Description
After #103686 I think part of the doc could be automated via scripting, at least for the following fields: