diff --git a/doc/0.getting_started.md b/doc/0.getting_started.md
index 1e365e8..9cb9053 100644
--- a/doc/0.getting_started.md
+++ b/doc/0.getting_started.md
@@ -219,7 +219,11 @@ provided that you name each of them uniquely.
 If you want to build the web assets, you can use `npm run build:dev`
 (respectively `npm run watch:dev` to build continuously and monitor changes in
 source files). You can use `npm run build:prod` (`npm run watch:prod`) to do
-the same in production mode (with minification etc).
+the same in production mode (main difference is minification of generated
+source code).
+
+**Note**: If `npm run build:prod` fails, you can fall back to `npm run
+build:dev` safely.
 
 
 ## Upgrading
diff --git a/doc/1.production.md b/doc/1.production.md
index 98731cf..f9a04d5 100644
--- a/doc/1.production.md
+++ b/doc/1.production.md
@@ -50,6 +50,9 @@ _Note 2_: As of 2019-03-13, building the webapp requires libpng-dev to be able t
 
     sudo apt install libpng-dev
 
+_Note 3_: If `npm run build:prod` fails, you can fall back to `npm run
+build:dev` safely.
+
 ## Use an alternative Bottle backend (production)
 
 This is the simplest option, offers good performances but is less scalable.