diff --git a/boilerplates/lerna-module/README.md b/boilerplates/lerna-module/README.md
index 4eb185106..c31f4c675 100644
--- a/boilerplates/lerna-module/README.md
+++ b/boilerplates/lerna-module/README.md
@@ -24,7 +24,7 @@ When first cloning the repo:
 
 ```sh
 yarn
-# build the prod packages, this will navigate from references to their definitions (.d.ts files) between packages.
+# build the prod packages. When devs would like to navigate to the source code, this will only navigate from references to their definitions (.d.ts files) between packages.
 yarn build
 ```
 
@@ -32,7 +32,7 @@ Or if you want to make your dev process smoother, you can run:
 
 ```sh
 yarn
-# build the dev packages, this enables navigation from references to their source code between packages.
+# build the dev packages with .map files, this enables navigation from references to their source code between packages.
 yarn build:dev
 ```
 
diff --git a/boilerplates/lerna-workspace/README.md b/boilerplates/lerna-workspace/README.md
index 4eb185106..c31f4c675 100644
--- a/boilerplates/lerna-workspace/README.md
+++ b/boilerplates/lerna-workspace/README.md
@@ -24,7 +24,7 @@ When first cloning the repo:
 
 ```sh
 yarn
-# build the prod packages, this will navigate from references to their definitions (.d.ts files) between packages.
+# build the prod packages. When devs would like to navigate to the source code, this will only navigate from references to their definitions (.d.ts files) between packages.
 yarn build
 ```
 
@@ -32,7 +32,7 @@ Or if you want to make your dev process smoother, you can run:
 
 ```sh
 yarn
-# build the dev packages, this enables navigation from references to their source code between packages.
+# build the dev packages with .map files, this enables navigation from references to their source code between packages.
 yarn build:dev
 ```