kibana/packages/kbn-docs-utils
Walter Rafelsberger b2f48f2d54
[spacetime] Improve scripts/build_api_docs stats output speed. (#157129)
The existing `build_api_docs` script takes about ~10m to run and
generate the API docs. That's not too bad for the daily CI task that
generates the docs. However, even if you're just interested in getting
some stats on a single plugin/package it runs the full script. We often
have to run this script locally to check the stats in detail to improve
JSDoc and missing exports which is quite cumbersome if it takes this
long to run after each code change.

This PR updates the script in the following way: If both the options
`--stats` and `--plugin` (with a single plugin/package) are set, it will
not generate a TS project for the whole Kibana codebase but just the
code related to that plugin/package. API docs will then not be written
to avoid inconsistencies and just the stats will be logged.

Depending on the size of the package/plugin this can reduce the time
needed to run the script down to a few seconds.
2023-06-01 14:10:59 +02:00
..
src [spacetime] Improve scripts/build_api_docs stats output speed. (#157129) 2023-06-01 14:10:59 +02:00
index.ts [docs-utils] remove extra api_docs dir (#148658) 2023-01-10 12:20:35 -07:00
jest.config.js Automatically generated Api documentation (#86232) 2021-02-24 19:23:19 -05:00
jest.integration.config.js [API Docs] Add @track-adoption (#138366) 2022-09-07 17:39:31 +02:00
kibana.jsonc Transpile packages on demand, validate all TS projects (#146212) 2022-12-22 19:00:29 -06:00
package.json Transpile packages on demand, validate all TS projects (#146212) 2022-12-22 19:00:29 -06:00
tsconfig.json [spacetime] Improve scripts/build_api_docs stats output speed. (#157129) 2023-06-01 14:10:59 +02:00