Merge pull request elastic#16 from spalger/migrate-to-docs-util-pkg

migrate to docs-util package
kobelb · Feb 9, 2021 · eed4042 · eed4042
2 parents 256acf6 + ec3598d
commit eed4042
Show file tree

Hide file tree

Showing 74 changed files with 111 additions and 92 deletions.
diff --git a/package.json b/package.json
@@ -373,7 +373,7 @@
     "@kbn/plugin-generator": "link:packages/kbn-plugin-generator",
     "@kbn/plugin-helpers": "link:packages/kbn-plugin-helpers",
     "@kbn/pm": "link:packages/kbn-pm",
-    "@kbn/release-notes": "link:packages/kbn-release-notes",
+    "@kbn/docs-utils": "link:packages/kbn-docs-utils",
     "@kbn/storybook": "link:packages/kbn-storybook",
     "@kbn/telemetry-tools": "link:packages/kbn-telemetry-tools",
     "@kbn/test": "link:packages/kbn-test",

diff --git a/packages/kbn-release-notes/jest.config.js → packages/kbn-docs-utils/jest.config.js b/packages/kbn-release-notes/jest.config.js → packages/kbn-docs-utils/jest.config.js
@@ -9,5 +9,5 @@
 module.exports = {
   preset: '@kbn/test',
   rootDir: '../..',
-  roots: ['<rootDir>/packages/kbn-release-notes'],
+  roots: ['<rootDir>/packages/kbn-docs-utils'],
 };
diff --git a/packages/kbn-release-notes/package.json → packages/kbn-docs-utils/package.json b/packages/kbn-release-notes/package.json → packages/kbn-docs-utils/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "@kbn/release-notes",
+  "name": "@kbn/docs-utils",
   "version": "1.0.0",
   "license": "SSPL-1.0 OR Elastic License 2.0",
   "private": "true",

diff --git a/src/dev/build_api_docs/README.md → ...ges/kbn-docs-utils/src/api_docs/README.md b/src/dev/build_api_docs/README.md → ...ges/kbn-docs-utils/src/api_docs/README.md
@@ -8,5 +8,5 @@ we determine the value of such a system and what kind of maintenance burder it w
 To generate the docs run 
 
 ```
-yarn build:apidocs
+node scripts/build_api_docs
 ```
diff --git a/...declarations/buid_api_declaration.test.ts → ...declarations/buid_api_declaration.test.ts b/...declarations/buid_api_declaration.test.ts → ...declarations/buid_api_declaration.test.ts
diff --git a/...api_declarations/build_api_declaration.ts → ...api_declarations/build_api_declaration.ts b/...api_declarations/build_api_declaration.ts → ...api_declarations/build_api_declaration.ts
diff --git a/...ld_api_declarations/build_arrow_fn_dec.ts → ...ld_api_declarations/build_arrow_fn_dec.ts b/...ld_api_declarations/build_arrow_fn_dec.ts → ...ld_api_declarations/build_arrow_fn_dec.ts
diff --git a/...build_api_declarations/build_class_dec.ts → ...build_api_declarations/build_class_dec.ts b/...build_api_declarations/build_class_dec.ts → ...build_api_declarations/build_class_dec.ts
diff --git a/...ld_api_declarations/build_function_dec.ts → ...ld_api_declarations/build_function_dec.ts b/...ld_api_declarations/build_function_dec.ts → ...ld_api_declarations/build_function_dec.ts
diff --git a/...i_declarations/build_function_type_dec.ts → ...i_declarations/build_function_type_dec.ts b/...i_declarations/build_function_type_dec.ts → ...i_declarations/build_function_type_dec.ts
diff --git a/...d_api_declarations/build_interface_dec.ts → ...d_api_declarations/build_interface_dec.ts b/...d_api_declarations/build_interface_dec.ts → ...d_api_declarations/build_interface_dec.ts
diff --git a/..._api_declarations/build_parameter_decs.ts → ..._api_declarations/build_parameter_decs.ts b/..._api_declarations/build_parameter_decs.ts → ..._api_declarations/build_parameter_decs.ts
diff --git a/...pi_declarations/build_type_literal_dec.ts → ...pi_declarations/build_type_literal_dec.ts b/...pi_declarations/build_type_literal_dec.ts → ...pi_declarations/build_type_literal_dec.ts
diff --git a/...ld_api_declarations/build_variable_dec.ts → ...ld_api_declarations/build_variable_dec.ts b/...ld_api_declarations/build_variable_dec.ts → ...ld_api_declarations/build_variable_dec.ts
diff --git a/..._declarations/extract_import_refs.test.ts → ..._declarations/extract_import_refs.test.ts b/..._declarations/extract_import_refs.test.ts → ..._declarations/extract_import_refs.test.ts
diff --git a/...d_api_declarations/extract_import_refs.ts → ...d_api_declarations/extract_import_refs.ts b/...d_api_declarations/extract_import_refs.ts → ...d_api_declarations/extract_import_refs.ts
diff --git a/...s/build_api_declarations/get_signature.ts → ...s/build_api_declarations/get_signature.ts b/...s/build_api_declarations/get_signature.ts → ...s/build_api_declarations/get_signature.ts
diff --git a/...s/build_api_declarations/get_type_kind.ts → ...s/build_api_declarations/get_type_kind.ts b/...s/build_api_declarations/get_type_kind.ts → ...s/build_api_declarations/get_type_kind.ts
diff --git a/...cs/build_api_declarations/js_doc_utils.ts → ...cs/build_api_declarations/js_doc_utils.ts b/...cs/build_api_declarations/js_doc_utils.ts → ...cs/build_api_declarations/js_doc_utils.ts
diff --git a/..._api_docs/build_api_declarations/utils.ts → .../api_docs/build_api_declarations/utils.ts b/..._api_docs/build_api_declarations/utils.ts → .../api_docs/build_api_declarations/utils.ts
diff --git a/src/dev/build_api_docs/build_api_docs.ts → ...-utils/src/api_docs/build_api_docs_cli.ts b/src/dev/build_api_docs/build_api_docs.ts → ...-utils/src/api_docs/build_api_docs_cli.ts
@@ -6,21 +6,69 @@
  * Side Public License, v 1.
  */
 
-import fs from 'fs';
+import Fs from 'fs';
 import Path from 'path';
-import { REPO_ROOT } from '@kbn/dev-utils';
-import { ToolingLog } from '@kbn/dev-utils';
+
+import { REPO_ROOT, run } from '@kbn/dev-utils';
 import { Project } from 'ts-morph';
+
 import { getPluginApi } from './get_plugin_api';
 import { writePluginDocs } from './mdx/write_plugin_mdx_docs';
-import { findPlugins } from '../plugin_discovery';
 import { ApiDeclaration, PluginApi } from './types';
 import { mergeScopeApi } from './utils';
+import { findPlugins } from './find_plugins';
+
+export function runBuildApiDocsCli() {
+  run(
+    async ({ log }) => {
+      const project = getTsProject(REPO_ROOT);
+
+      const plugins = findPlugins();
+
+      const pluginInfos: Array<{
+        apiCount: number;
+        apiCountMissingComments: number;
+        plugin: string;
+      }> = [];
+
+      const outputFolder = Path.resolve(REPO_ROOT, 'api_docs');
+      if (!Fs.existsSync(outputFolder)) {
+        Fs.mkdirSync(outputFolder);
+      } else {
+        // Delete all files except the README that warns about the auto-generated nature of
+        // the folder.
+        const files = Fs.readdirSync(outputFolder);
+        files.forEach((file) => {
+          if (file.indexOf('README.md') < 0) {
+            Fs.rmSync(Path.resolve(outputFolder, file));
+          }
+        });
+      }
+
+      plugins.forEach((plugin) => {
+        const doc = getPluginApi(project, plugin, plugins, log);
+        const info = {
+          plugin: plugin.manifest.id,
+          apiCount: countApiForPlugin(doc),
+          apiCountMissingComments: countMissingCommentsApiForPlugin(doc),
+        };
+
+        if (info.apiCount > 0) {
+          writePluginDocs(outputFolder, doc, log);
+          pluginInfos.push(info);
+        }
+      });
 
-const log = new ToolingLog({
-  level: 'debug',
-  writeTo: process.stdout,
-});
+      // eslint-disable-next-line no-console
+      console.table(pluginInfos);
+    },
+    {
+      log: {
+        defaultLevel: 'debug',
+      },
+    }
+  );
+}
 
 function getTsProject(repoPath: string) {
   const xpackTsConfig = `${repoPath}/x-pack/tsconfig.json`;
@@ -34,56 +82,6 @@ function getTsProject(repoPath: string) {
   return project;
 }
 
-export function buildApiDocs() {
-  const project = getTsProject(REPO_ROOT);
-
-  const plugins = Array.from(
-    findPlugins({
-      oss: false,
-      examples: false,
-      // Use this to capture "core" as a plugin.
-      extraPluginScanDirs: [Path.resolve(REPO_ROOT, 'src')],
-    }).values()
-  );
-
-  const pluginInfos: Array<{
-    apiCount: number;
-    apiCountMissingComments: number;
-    plugin: string;
-  }> = [];
-
-  const outputFolder = Path.resolve(REPO_ROOT, 'api_docs');
-  if (!fs.existsSync(outputFolder)) {
-    fs.mkdirSync(outputFolder);
-  } else {
-    // Delete all files except the README that warns about the auto-generated nature of
-    // the folder.
-    const files = fs.readdirSync(outputFolder);
-    files.forEach((file) => {
-      if (file.indexOf('README.md') < 0) {
-        fs.rmSync(Path.resolve(outputFolder, file));
-      }
-    });
-  }
-
-  plugins.forEach((plugin) => {
-    const doc = getPluginApi(project, plugin, plugins, log);
-    const info = {
-      plugin: plugin.manifest.id,
-      apiCount: countApiForPlugin(doc),
-      apiCountMissingComments: countMissingCommentsApiForPlugin(doc),
-    };
-
-    if (info.apiCount > 0) {
-      writePluginDocs(outputFolder, doc, log);
-      pluginInfos.push(info);
-    }
-  });
-
-  // eslint-disable-next-line no-console
-  console.table(pluginInfos);
-}
-
 function countMissingCommentsApiForPlugin(doc: PluginApi) {
   return (
     mergeScopeApi(doc.client).reduce((sum, def) => {

diff --git a/packages/kbn-docs-utils/src/api_docs/find_plugins.ts b/packages/kbn-docs-utils/src/api_docs/find_plugins.ts
@@ -0,0 +1,25 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import Path from 'path';
+
+import { getPluginSearchPaths } from '@kbn/config';
+import { simpleKibanaPlatformPluginDiscovery, REPO_ROOT } from '@kbn/dev-utils';
+
+export function findPlugins() {
+  const pluginSearchPaths = getPluginSearchPaths({
+    rootDir: REPO_ROOT,
+    oss: false,
+    examples: false,
+  });
+
+  return simpleKibanaPlatformPluginDiscovery(pluginSearchPaths, [
+    // discover "core" as a plugin
+    Path.resolve(REPO_ROOT, 'src/core'),
+  ]);
+}
diff --git a/..._docs/get_declaration_nodes_for_plugin.ts → ..._docs/get_declaration_nodes_for_plugin.ts b/..._docs/get_declaration_nodes_for_plugin.ts → ..._docs/get_declaration_nodes_for_plugin.ts
diff --git a/src/dev/build_api_docs/get_plugin_api.ts → ...docs-utils/src/api_docs/get_plugin_api.ts b/src/dev/build_api_docs/get_plugin_api.ts → ...docs-utils/src/api_docs/get_plugin_api.ts
diff --git a/src/dev/build_api_docs/run.ts → ...ages/kbn-docs-utils/src/api_docs/index.ts b/src/dev/build_api_docs/run.ts → ...ages/kbn-docs-utils/src/api_docs/index.ts
@@ -6,6 +6,4 @@
  * Side Public License, v 1.
  */
 
-import { buildApiDocs } from './build_api_docs';
-
-buildApiDocs();
+export * from './build_api_docs_cli';
diff --git a/...api_docs/mdx/split_apis_by_folder.test.ts → ...api_docs/mdx/split_apis_by_folder.test.ts b/...api_docs/mdx/split_apis_by_folder.test.ts → ...api_docs/mdx/split_apis_by_folder.test.ts
diff --git a/...ild_api_docs/mdx/write_plugin_mdx_docs.ts → ...src/api_docs/mdx/write_plugin_mdx_docs.ts b/...ild_api_docs/mdx/write_plugin_mdx_docs.ts → ...src/api_docs/mdx/write_plugin_mdx_docs.ts
diff --git a/.../mdx/write_plugin_split_by_folder.test.ts → .../mdx/write_plugin_split_by_folder.test.ts b/.../mdx/write_plugin_split_by_folder.test.ts → .../mdx/write_plugin_split_by_folder.test.ts
diff --git a/..._docs/mdx/write_plugin_split_by_folder.ts → ..._docs/mdx/write_plugin_split_by_folder.ts b/..._docs/mdx/write_plugin_split_by_folder.ts → ..._docs/mdx/write_plugin_split_by_folder.ts
diff --git a/...cs/tests/src/plugin_a/common/foo/index.ts → ...xtures__/src/plugin_a/common/foo/index.ts b/...cs/tests/src/plugin_a/common/foo/index.ts → ...xtures__/src/plugin_a/common/foo/index.ts
diff --git a/...i_docs/tests/src/plugin_a/common/index.ts → ...__fixtures__/src/plugin_a/common/index.ts b/...i_docs/tests/src/plugin_a/common/index.ts → ...__fixtures__/src/plugin_a/common/index.ts
diff --git a/...d_api_docs/tests/src/plugin_a/kibana.json → ...sts/__fixtures__/src/plugin_a/kibana.json b/...d_api_docs/tests/src/plugin_a/kibana.json → ...sts/__fixtures__/src/plugin_a/kibana.json
diff --git a/...docs/tests/src/plugin_a/public/classes.ts → ...fixtures__/src/plugin_a/public/classes.ts b/...docs/tests/src/plugin_a/public/classes.ts → ...fixtures__/src/plugin_a/public/classes.ts
diff --git a/...s/tests/src/plugin_a/public/const_vars.ts → ...tures__/src/plugin_a/public/const_vars.ts b/...s/tests/src/plugin_a/public/const_vars.ts → ...tures__/src/plugin_a/public/const_vars.ts
diff --git a/...api_docs/tests/src/plugin_a/public/fns.ts → ...s/__fixtures__/src/plugin_a/public/fns.ts b/...api_docs/tests/src/plugin_a/public/fns.ts → ...s/__fixtures__/src/plugin_a/public/fns.ts
diff --git a/...cs/tests/src/plugin_a/public/foo/index.ts → ...xtures__/src/plugin_a/public/foo/index.ts b/...cs/tests/src/plugin_a/public/foo/index.ts → ...xtures__/src/plugin_a/public/foo/index.ts
diff --git a/...i_docs/tests/src/plugin_a/public/index.ts → ...__fixtures__/src/plugin_a/public/index.ts b/...i_docs/tests/src/plugin_a/public/index.ts → ...__fixtures__/src/plugin_a/public/index.ts
diff --git a/..._docs/tests/src/plugin_a/public/plugin.ts → ..._fixtures__/src/plugin_a/public/plugin.ts b/..._docs/tests/src/plugin_a/public/plugin.ts → ..._fixtures__/src/plugin_a/public/plugin.ts
diff --git a/...i_docs/tests/src/plugin_a/public/types.ts → ...__fixtures__/src/plugin_a/public/types.ts b/...i_docs/tests/src/plugin_a/public/types.ts → ...__fixtures__/src/plugin_a/public/types.ts
diff --git a/...ev/build_api_docs/tests/src/tsconfig.json → ...docs/tests/__fixtures__/src/tsconfig.json b/...ev/build_api_docs/tests/src/tsconfig.json → ...docs/tests/__fixtures__/src/tsconfig.json
diff --git a/...uild_api_docs/tests/api_doc_suite.test.ts → .../src/api_docs/tests/api_doc_suite.test.ts b/...uild_api_docs/tests/api_doc_suite.test.ts → .../src/api_docs/tests/api_doc_suite.test.ts
@@ -8,8 +8,8 @@
 
 import fs from 'fs';
 import Path from 'path';
+
 import { Project } from 'ts-morph';
-import { REPO_ROOT } from '@kbn/utils';
 import { ToolingLog, KibanaPlatformPlugin } from '@kbn/dev-utils';
 
 import { writePluginDocs } from '../mdx/write_plugin_mdx_docs';
@@ -75,15 +75,7 @@ function fnIsCorrect(fn: ApiDeclaration | undefined) {
 }
 
 beforeAll(() => {
-  const tsConfigFilePath = Path.resolve(
-    REPO_ROOT,
-    'src',
-    'dev',
-    'build_api_docs',
-    'tests',
-    'src',
-    'tsconfig.json'
-  );
+  const tsConfigFilePath = Path.resolve(__dirname, '__fixtures__/src/tsconfig.json');
   const project = new Project({
     tsConfigFilePath,
   });
@@ -95,7 +87,7 @@ beforeAll(() => {
   const plugins: KibanaPlatformPlugin[] = [pluginA];
 
   doc = getPluginApi(project, plugins[0], plugins, log);
-  mdxOutputFolder = Path.resolve(REPO_ROOT, 'src', 'dev', 'build_api_docs', 'tests', 'snapshots');
+  mdxOutputFolder = Path.resolve(__dirname, 'snapshots');
   writePluginDocs(mdxOutputFolder, doc, log);
 });
 
@@ -131,8 +123,8 @@ it('const exported from common folder is correct', () => {
   const fooConst = doc.common.misc.find((c) => c.label === 'commonFoo');
   expect(fooConst).toBeDefined();
 
-  expect(fooConst!.source.path.indexOf('src/plugin_a/common/foo/index.ts')).toBeGreaterThanOrEqual(
-    0
+  expect(fooConst!.source.path.replace(Path.sep, '/')).toContain(
+    'src/plugin_a/common/foo/index.ts'
   );
   expect(fooConst!.signature![0]).toBe('"COMMON VAR!"');
 });

diff --git a/...docs/tests/kibana_platform_plugin_mock.ts → ...docs/tests/kibana_platform_plugin_mock.ts b/...docs/tests/kibana_platform_plugin_mock.ts → ...docs/tests/kibana_platform_plugin_mock.ts
diff --git a/...ld_api_docs/tests/snapshots/plugin_a.json → ...rc/api_docs/tests/snapshots/plugin_a.json b/...ld_api_docs/tests/snapshots/plugin_a.json → ...rc/api_docs/tests/snapshots/plugin_a.json
diff --git a/...ild_api_docs/tests/snapshots/plugin_a.mdx → ...src/api_docs/tests/snapshots/plugin_a.mdx b/...ild_api_docs/tests/snapshots/plugin_a.mdx → ...src/api_docs/tests/snapshots/plugin_a.mdx
diff --git a/...pi_docs/tests/snapshots/plugin_a_foo.json → ...pi_docs/tests/snapshots/plugin_a_foo.json b/...pi_docs/tests/snapshots/plugin_a_foo.json → ...pi_docs/tests/snapshots/plugin_a_foo.json
diff --git a/...api_docs/tests/snapshots/plugin_a_foo.mdx → ...api_docs/tests/snapshots/plugin_a_foo.mdx b/...api_docs/tests/snapshots/plugin_a_foo.mdx → ...api_docs/tests/snapshots/plugin_a_foo.mdx
diff --git a/src/dev/build_api_docs/tsmorph_utils.ts → ...-docs-utils/src/api_docs/tsmorph_utils.ts b/src/dev/build_api_docs/tsmorph_utils.ts → ...-docs-utils/src/api_docs/tsmorph_utils.ts
diff --git a/src/dev/build_api_docs/types.ts → ...ages/kbn-docs-utils/src/api_docs/types.ts b/src/dev/build_api_docs/types.ts → ...ages/kbn-docs-utils/src/api_docs/types.ts
diff --git a/src/dev/build_api_docs/utils.test.ts → ...kbn-docs-utils/src/api_docs/utils.test.ts b/src/dev/build_api_docs/utils.test.ts → ...kbn-docs-utils/src/api_docs/utils.test.ts
@@ -6,18 +6,11 @@
  * Side Public License, v 1.
  */
 
-import { KibanaPlatformPlugin } from '@kbn/dev-utils';
-import { findPlugins } from '../plugin_discovery';
+import { findPlugins } from './find_plugins';
 import { getPluginForPath, getServiceForPath } from './utils';
 
 it('test getPluginForPath', () => {
-  const plugins: KibanaPlatformPlugin[] = Array.from(
-    findPlugins({
-      oss: false,
-      examples: false,
-      extraPluginScanDirs: [],
-    }).values()
-  );
+  const plugins = findPlugins();
   expect(
     getPluginForPath('/Users/auser/kibana/src/plugins/embeddable/public/service/file.ts', plugins)
   ).toBeDefined();

diff --git a/src/dev/build_api_docs/utils.ts → ...ages/kbn-docs-utils/src/api_docs/utils.ts b/src/dev/build_api_docs/utils.ts → ...ages/kbn-docs-utils/src/api_docs/utils.ts
diff --git a/packages/kbn-docs-utils/src/index.ts b/packages/kbn-docs-utils/src/index.ts
@@ -0,0 +1,10 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+export * from './release_notes';
+export * from './api_docs';
diff --git a/packages/kbn-release-notes/src/cli.ts → ...s/kbn-docs-utils/src/release_notes/cli.ts b/packages/kbn-release-notes/src/cli.ts → ...s/kbn-docs-utils/src/release_notes/cli.ts
diff --git a/...kbn-release-notes/src/formats/asciidoc.ts → ...ils/src/release_notes/formats/asciidoc.ts b/...kbn-release-notes/src/formats/asciidoc.ts → ...ils/src/release_notes/formats/asciidoc.ts
diff --git a/...ages/kbn-release-notes/src/formats/csv.ts → ...cs-utils/src/release_notes/formats/csv.ts b/...ages/kbn-release-notes/src/formats/csv.ts → ...cs-utils/src/release_notes/formats/csv.ts
diff --git a/...s/kbn-release-notes/src/formats/format.ts → ...utils/src/release_notes/formats/format.ts b/...s/kbn-release-notes/src/formats/format.ts → ...utils/src/release_notes/formats/format.ts
diff --git a/...es/kbn-release-notes/src/formats/index.ts → ...-utils/src/release_notes/formats/index.ts b/...es/kbn-release-notes/src/formats/index.ts → ...-utils/src/release_notes/formats/index.ts
diff --git a/packages/kbn-release-notes/src/index.ts → ...kbn-docs-utils/src/release_notes/index.ts b/packages/kbn-release-notes/src/index.ts → ...kbn-docs-utils/src/release_notes/index.ts
diff --git a/.../kbn-release-notes/src/lib/classify_pr.ts → ...tils/src/release_notes/lib/classify_pr.ts b/.../kbn-release-notes/src/lib/classify_pr.ts → ...tils/src/release_notes/lib/classify_pr.ts
diff --git a/...-notes/src/lib/get_fix_references.test.ts → ...ease_notes/lib/get_fix_references.test.ts b/...-notes/src/lib/get_fix_references.test.ts → ...ease_notes/lib/get_fix_references.test.ts
diff --git a/...lease-notes/src/lib/get_fix_references.ts → ...c/release_notes/lib/get_fix_references.ts b/...lease-notes/src/lib/get_fix_references.ts → ...c/release_notes/lib/get_fix_references.ts
diff --git a/...src/lib/get_note_from_description.test.ts → ...tes/lib/get_note_from_description.test.ts b/...src/lib/get_note_from_description.test.ts → ...tes/lib/get_note_from_description.test.ts
diff --git a/...otes/src/lib/get_note_from_description.ts → ...se_notes/lib/get_note_from_description.ts b/...otes/src/lib/get_note_from_description.ts → ...se_notes/lib/get_note_from_description.ts
diff --git a/packages/kbn-release-notes/src/lib/index.ts → ...docs-utils/src/release_notes/lib/index.ts b/packages/kbn-release-notes/src/lib/index.ts → ...docs-utils/src/release_notes/lib/index.ts
diff --git a/...se-notes/src/lib/irrelevant_pr_summary.ts → ...elease_notes/lib/irrelevant_pr_summary.ts b/...se-notes/src/lib/irrelevant_pr_summary.ts → ...elease_notes/lib/irrelevant_pr_summary.ts
diff --git a/...n-release-notes/src/lib/is_pr_relevant.ts → ...s/src/release_notes/lib/is_pr_relevant.ts b/...n-release-notes/src/lib/is_pr_relevant.ts → ...s/src/release_notes/lib/is_pr_relevant.ts
diff --git a/packages/kbn-release-notes/src/lib/pr_api.ts → ...ocs-utils/src/release_notes/lib/pr_api.ts b/packages/kbn-release-notes/src/lib/pr_api.ts → ...ocs-utils/src/release_notes/lib/pr_api.ts
diff --git a/...ages/kbn-release-notes/src/lib/streams.ts → ...cs-utils/src/release_notes/lib/streams.ts b/...ages/kbn-release-notes/src/lib/streams.ts → ...cs-utils/src/release_notes/lib/streams.ts
diff --git a/...kbn-release-notes/src/lib/type_helpers.ts → ...ils/src/release_notes/lib/type_helpers.ts b/...kbn-release-notes/src/lib/type_helpers.ts → ...ils/src/release_notes/lib/type_helpers.ts
diff --git a/...kbn-release-notes/src/lib/version.test.ts → ...ils/src/release_notes/lib/version.test.ts b/...kbn-release-notes/src/lib/version.test.ts → ...ils/src/release_notes/lib/version.test.ts
diff --git a/...ages/kbn-release-notes/src/lib/version.ts → ...cs-utils/src/release_notes/lib/version.ts b/...ages/kbn-release-notes/src/lib/version.ts → ...cs-utils/src/release_notes/lib/version.ts
diff --git a/...release-notes/src/release_notes_config.ts → ...src/release_notes/release_notes_config.ts b/...release-notes/src/release_notes_config.ts → ...src/release_notes/release_notes_config.ts
diff --git a/packages/kbn-release-notes/tsconfig.json → packages/kbn-docs-utils/tsconfig.json b/packages/kbn-release-notes/tsconfig.json → packages/kbn-docs-utils/tsconfig.json
@@ -8,5 +8,8 @@
   },
   "include": [
     "src/**/*"
+  ],
+  "exclude": [
+    "**/__fixtures__/**/*"
   ]
 }
diff --git a/scripts/build_api_docs.js b/scripts/build_api_docs.js
@@ -7,4 +7,4 @@
  */
 
 require('../src/setup_node_env');
-require('../src/dev/build_api_docs/run');
+require('@kbn/docs-utils').runBuildApiDocsCli();
diff --git a/yarn.lock b/yarn.lock
@@ -3445,6 +3445,10 @@
   version "0.0.0"
   uid ""
 
+"@kbn/docs-utils@link:packages/kbn-docs-utils":
+  version "0.0.0"
+  uid ""
+
 "@kbn/es-archiver@link:packages/kbn-es-archiver":
   version "0.0.0"
   uid ""
@@ -3501,10 +3505,6 @@
   version "0.0.0"
   uid ""
 
-"@kbn/release-notes@link:packages/kbn-release-notes":
-  version "0.0.0"
-  uid ""
-
 "@kbn/std@link:packages/kbn-std":
   version "0.0.0"
   uid ""