From 342b1fa1a42a7c6333c2f4feb48a9191d67ab75a Mon Sep 17 00:00:00 2001
From: Grzegorz Ziolkowski <grzegorz@gziolo.pl>
Date: Thu, 11 Oct 2018 16:56:59 +0200
Subject: [PATCH] Add inline comments for global variables used with Webpack

---
 webpack.config.js | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/webpack.config.js b/webpack.config.js
index afa358b564b34..78085c77bbbf8 100644
--- a/webpack.config.js
+++ b/webpack.config.js
@@ -217,7 +217,7 @@ const config = {
 				to: `./build/${ packageName }/`,
 				flatten: true,
 				transform: ( content ) => {
-					if ( isProduction ) {
+					if ( config.mode === 'production' ) {
 						return postcss( [
 							require( 'cssnano' )( {
 								preset: 'default',
@@ -230,7 +230,11 @@ const config = {
 				},
 			} ) )
 		),
+		// GUTENBERG_BUNDLE_ANALYZER global variable enables utility that represents bundle content
+		// as convenient interactive zoomable treemap.
 		process.env.GUTENBERG_BUNDLE_ANALYZER && new BundleAnalyzerPlugin(),
+		// GUTENBERG_LIVE_RELOAD_PORT global variable changes port on which live reload works
+		// when running watch mode.
 		! isProduction && new LiveReloadPlugin( { port: process.env.GUTENBERG_LIVE_RELOAD_PORT || 35729 } ),
 	].filter( Boolean ),
 	stats: {
@@ -239,6 +243,8 @@ const config = {
 };
 
 if ( ! isProduction ) {
+	// GUTENBERG_DEVTOOL global variable controls how source maps are generated.
+	// See: https://webpack.js.org/configuration/devtool/#devtool.
 	config.devtool = process.env.GUTENBERG_DEVTOOL || 'source-map';
 }