diff --git a/docs/pnpm-workspace_yaml.md b/docs/pnpm-workspace_yaml.md
index 22faf8ecf9f5..3165cb6aa8aa 100644
--- a/docs/pnpm-workspace_yaml.md
+++ b/docs/pnpm-workspace_yaml.md
@@ -11,6 +11,8 @@ For example:
 
 ```yaml title="pnpm-workspace.yaml"
 packages:
+  # specify a package in a direct subdir of the root
+  - 'my-app'
   # all packages in direct subdirs of packages/
   - 'packages/*'
   # all packages in subdirs of components/