chore: document build --types

diff --git a/.github/contributing.md b/.github/contributing.md
index 0a610a88d39d881639cefce25d207df65231e120..92b4c0795af42cda0a590ad40c7d3cf153341e05 100644 (file)
--- a/.github/contributing.md
+++ b/.github/contributing.md
@@ -88,6 +88,14 @@ Multiple formats can be specified as a comma-separated list:
 yarn build runtime-core -f esm,cjs
 ```
 
+#### Build with Type Declarations
+
+The `--types` flag will generate type declarations during the build and in addition:
+
+- Roll the declarations into a single `.dts` file for each package;
+- Generate an API report in `<projectRoot>/temp/<packageName>.api.md`. This report contains potential warnings emitted by [api-extractor](https://api-extractor.com/).
+- Generate an API model json in `<projectRoot>/temp/<packageName>.api.md`. This file can be used to generate a Markdown version of the exported APIs.
+
 ### `yarn dev`
 
 The `dev` script bundles a target package (default: `vue`) in a specified format (default: `global`) in dev mode and watches for changes. This is useful when you want to load up a build in an HTML page for quick debugging: