rename to printBuildError and add link to the docs

Author: viankakrisna

packages/react-dev-utils/README.md

@@ -220,17 +220,17 @@ compiler.plugin('done', function(stats) {
 });
 ```
 
-#### `formatBuildError(error: Object): String`
+#### `printBuildError(error: Object): String`
 
 Prettify some known build errors.
 Pass an Error object to log a prettified error message in the console
 
 ```
-  const formatBuildError = require('react-dev-utils/formatBuildError')
+  const printBuildError = require('react-dev-utils/printBuildError')
   try {
     build()
-  } catch(e){
-    formatBuildError(e) // logs prettified message
+  } catch(e) {
+    printBuildError(e) // logs prettified message
   }
 ```
 

packages/react-dev-utils/package.json

@@ -18,7 +18,7 @@
     "crossSpawn.js",
     "eslintFormatter.js",
     "FileSizeReporter.js",
-    "formatBuildError.js",
+    "printBuildError.js",
     "formatWebpackMessages.js",
     "getProcessForPort.js",
     "inquirer.js",

packages/react-dev-utils/formatBuildError.js renamed to packages/react-dev-utils/printBuildError.js

@@ -12,7 +12,7 @@
 const get = require('lodash/get');
 const chalk = require('chalk');
 
-module.exports = function formatBuildError(err) {
+module.exports = function printBuildError(err) {
   const message = get(err, 'message');
   const stack = get(err, 'stack');
 
@@ -43,10 +43,8 @@ module.exports = function formatBuildError(err) {
       console.log('Failed to minify the code.', err);
     }
     console.log(
-      'Please check your dependencies for any untranspiled es6 code and raise an issue with \n' +
-        'the author. \n' +
-        '\nIf you need to use the module right now, you can try placing the source in ./src \n' +
-        'and we will transpile it for you.'
+      'Read more here: \n',
+      'https://github.com/facebookincubator/create-react-app/blob/master/packages/react-scripts/template/README.md#npm-run-build-fails-to-minify'
     );
   } else {
     console.log((message || err) + '\n');

packages/react-scripts/scripts/build.js

@@ -34,9 +34,10 @@ const checkRequiredFiles = require('react-dev-utils/checkRequiredFiles');
 const formatWebpackMessages = require('react-dev-utils/formatWebpackMessages');
 const printHostingInstructions = require('react-dev-utils/printHostingInstructions');
 const FileSizeReporter = require('react-dev-utils/FileSizeReporter');
-const formatBuildError = require('react-dev-utils/formatBuildError');
+const printBuildError = require('react-dev-utils/printBuildError');
 
-const measureFileSizesBeforeBuild = FileSizeReporter.measureFileSizesBeforeBuild;
+const measureFileSizesBeforeBuild =
+  FileSizeReporter.measureFileSizesBeforeBuild;
 const printFileSizesAfterBuild = FileSizeReporter.printFileSizesAfterBuild;
 const useYarn = fs.existsSync(paths.yarnLockFile);
 
@@ -94,7 +95,7 @@ measureFileSizesBeforeBuild(paths.appBuild)
     },
     err => {
       console.log(chalk.red('Failed to compile.\n'));
-      formatBuildError(err);
+      printBuildError(err);
       process.exit(1);
     }
   );

packages/react-scripts/template/README.md

@@ -87,6 +87,7 @@ You can find the most recent version of this guide [here](https://github.com/fac
   - [`npm test` hangs on macOS Sierra](#npm-test-hangs-on-macos-sierra)
   - [`npm run build` exits too early](#npm-run-build-exits-too-early)
   - [`npm run build` fails on Heroku](#npm-run-build-fails-on-heroku)
+  - [`npm run build` fails to minify](#npm-run-build-fails-to-minify)
   - [Moment.js locales are missing](#momentjs-locales-are-missing)
 - [Something Missing?](#something-missing)
 
@@ -1998,6 +1999,16 @@ moment.locale('fr');
 
 This will only work for locales that have been explicitly imported before.
 
+### `npm run build` fails to minify
+
+Some dependencies may be shipping their source which our minify can't process.
+Because running Babel on `node_modules` is slow, we cannot compile it to es5 
+before minifying it. Possible solutions are:
+1. Raise an issue with the library author to ship compiled es5.
+2. If it's small and compatible with out babel preset, you can place the
+source in ./src.
+3. Fork the project repo and publish an es5 version of it.
+
 ## Something Missing?
 
 If you have ideas for more “How To” recipes that should be on this page, [let us know](https://github.com/facebookincubator/create-react-app/issues) or [contribute some!](https://github.com/facebookincubator/create-react-app/edit/master/packages/react-scripts/template/README.md)