diff --git a/addons/docs/web-components/README.md b/addons/docs/web-components/README.md
index 9713f42e1fed..35c0083f7a79 100644
--- a/addons/docs/web-components/README.md
+++ b/addons/docs/web-components/README.md
@@ -35,7 +35,16 @@ Known analyzers that output `custom-elements.json`:
 - [stenciljs](https://stenciljs.com/)
   - Supports Stencil (but does not have all metadata)
 
-It basically looks like this:
+To generate this file with Stencil, add `docs-vscode` to outputTargets in `stencil.config.ts`:
+
+```
+{
+  type: 'docs-vscode',
+  file: 'custom-elements.json'
+},
+```
+
+The file looks somewthing like this:
 
 ```json
 {