* [ML] WIP apiDoc schema extractor
* [ML] extract actual type
* [ML] refactor schema definitions
* [ML] Update README.md
* [ML] extract nested
* [ML] call job validation endpoint with complete payload
* [ML] escape special chars and fix line breaks
* [ML] clean up extractDocEntries
* [ML] serializeWithType
* [ML] add missing annotations
* [ML] fix parent schema assigment
* [ML] support object composition
* [ML] support multiple schemas per block
* [ML] fix for collections
* [ML] fix calendarIdsSchema
* [ML] add ml package.json with apidoc commands
* [ML] use the single output markdown file
* [ML] fix typo
* [ML] change the Calendars order
* [ML] adjust the order in adidoc.json
* [ML] update api version
* [ML] update tsconfig.json include
* [ML] update packages/kbn-pm/dist/index.js
* [ML] update ML overrides in .eslintrc.js
* [ML] yarn.lock symlink
* Revert "[ML] yarn.lock symlink"
This reverts commit 07f06801
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
1,006 B
ML Kibana API routes
This folder contains ML API routes in Kibana.
Each route handler requires apiDoc annotations in order to generate documentation. The apidoc-markdown package is also required in order to generate the markdown.
There are custom parser and worker (x-pack/plugins/ml/server/routes/apidoc_scripts
) to process api schemas for each documentation entry. It's written with typescript so make sure all the scripts in the folder are compiled before executing apidoc
command.
Make sure you have run yarn kbn bootstrap
to get all requires dev dependencies. Then execute the following command from the ml plugin folder:
yarn run apiDocs
It compiles all the required scripts and generates the documentation both in HTML and Markdown formats.
It will create a new directory routes_doc
(next to the routes
folder) which contains the documentation in HTML format
as well as ML_API.md
file.