chore(docs): add lerna watch -- build --include-dependents example (#…

…3512)
lerna · Feb 3, 2023 · aea79df · aea79df
1 parent 1fe6188
commit aea79df
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/packages/lerna/src/commands/watch/README.md b/packages/lerna/src/commands/watch/README.md
@@ -36,6 +36,12 @@ Watch only package "package-4" and its dependencies and run the `test` script fo
 $ lerna watch --scope="package-4" --include-dependencies -- lerna run test --scope=\$LERNA_PACKAGE_NAME
 ```
 
+Watch all packages and run the `build` script for the package that changed and all packages that depend on it:
+
+```sh
+$ lerna watch -- lerna run build --scope=\$LERNA_PACKAGE_NAME --include-dependents
+```
+
 When using `npx`, the `-c` option must be used if also providing variables for substitution:
 
 ```sh

diff --git a/website/docs/features/workspace-watching.md b/website/docs/features/workspace-watching.md
@@ -46,6 +46,12 @@ Watch a single package and its dependencies, running the "build" script on any o
 $ lerna watch --scope="my-package-1" --include-dependencies -- lerna run build --scope=\$LERNA_PACKAGE_NAME
 ```
 
+Watch all packages and run the `build` script for the package that changed and all packages that depend on it:
+
+```sh
+$ lerna watch -- lerna run build --scope=\$LERNA_PACKAGE_NAME --include-dependents
+```
+
 For more advanced filtering, see the [filter options](https://lerna.js.org/docs/api-reference/commands#filter-options) documentation. For more available options, see the [`lerna watch`](https://github.com/lerna/lerna/tree/main/packages/lerna/src/commands/watch#lerna-watch) documentation.
 
 ## Watch Environment Variables