Add "minimizing bundle size" guide

Author: taion

Diff for: docs/README.md

@@ -1,20 +1,21 @@
 ## Table of Contents
 
-* [Introduction](/docs/Introduction.md)
-* [Basics](/docs/guides/basics/README.md)
- * [Route Configuration](/docs/guides/basics/RouteConfiguration.md)
- * [Route Matching](/docs/guides/basics/RouteMatching.md)
- * [Histories](/docs/guides/basics/Histories.md)
- * [Index Routes and Links](/docs/guides/basics/IndexRoutes.md)
-* [Advanced Usage](/docs/guides/advanced/README.md)
- * [Dynamic Routing](/docs/guides/advanced/DynamicRouting.md)
- * [Confirming Navigation](/docs/guides/advanced/ConfirmingNavigation.md)
- * [Server Rendering](/docs/guides/advanced/ServerRendering.md)
- * [Component Lifecycle](/docs/guides/advanced/ComponentLifecycle.md)
- * [Navigating Outside of Components](/docs/guides/advanced/NavigatingOutsideOfComponents.md)
+* [Introduction](Introduction.md)
+* [Basics](guides/basics/README.md)
+ * [Route Configuration](guides/basics/RouteConfiguration.md)
+ * [Route Matching](guides/basics/RouteMatching.md)
+ * [Histories](guides/basics/Histories.md)
+ * [Index Routes and Links](guides/basics/IndexRoutes.md)
+* [Advanced Usage](guides/advanced/README.md)
+ * [Dynamic Routing](guides/advanced/DynamicRouting.md)
+ * [Confirming Navigation](guides/advanced/ConfirmingNavigation.md)
+ * [Server Rendering](guides/advanced/ServerRendering.md)
+ * [Component Lifecycle](guides/advanced/ComponentLifecycle.md)
+ * [Navigating Outside of Components](guides/advanced/NavigatingOutsideOfComponents.md)
+ * [Minimizing Bundle Size](guides/advanced/MinimizingBundleSize.md)
 * [Change Log](/CHANGES.md)
  * [Upgrading to v1.0.0](../upgrade-guides/v1.0.0.md)
  * [Upgrading to v2.0.0](../upgrade-guides/v2.0.0.md)
-* [Troubleshooting](/docs/Troubleshooting.md)
-* [API](/docs/API.md)
-* [Glossary](/docs/Glossary.md)
+* [Troubleshooting](Troubleshooting.md)
+* [API](API.md)
+* [Glossary](Glossary.md)

Diff for: docs/guides/advanced/MinimizingBundleSize.md

@@ -0,0 +1,31 @@
+# Minimizing Bundle Size
+
+For convenience, React Router exposes its full API on the top-level `react-router` import. However, this causes the entire React Router library and its dependencies to be included in client bundles that include code that makes any imports from the top-level CommonJS bundle.
+
+There are two options for minimizing client bundle size by excluding unused modules.
+
+
+## Import from `react-router/lib`
+
+Bindings exported from `react-router` are also available in `react-router/lib`. When using CommonJS models, you can import directly from `react-router/lib` to avoid pulling in unused modules.
+
+Assuming you are transpiling ES2015 modules into CommonJS modules, instead of
+
+```js
+import { Link, Route, Router } from 'react-router'
+```
+
+use
+
+```js
+import Link from 'react-router/lib/Link'
+import Route from 'react-router/lib/Route'
+import Router from 'react-router/lib/Router'
+```
+
+The public API available in this manner is defined as the set of imports available from the top-level `react-router` module. Anything not available through the top-level `react-router` module is a private API, and is subject to change without notice.
+
+
+## Use a Bundler with ES2015 Module Support
+
+React Router offers a ES2015 module build under `es6/` and defines a `jsnext:main` entry point. If you are using a bundler that supports ES2015 modules and tree-shaking such as webpack 2 or Rollup, you can directly import from `react-router`, as long as you are correctly resolving to the ES2015 module build.

Diff for: docs/guides/advanced/README.md

@@ -5,3 +5,4 @@
 * [Server Rendering](ServerRendering.md)
 * [Component Lifecycle](ComponentLifecycle.md)
 * [Navigating Outside of Components](NavigatingOutsideOfComponents.md)
+* [Minimizing Bundle Size](MinimizingBundleSize.md)

Diff for: modules/createMemoryHistory.js

@@ -11,4 +11,3 @@ export default function createMemoryHistory(options) {
   history.__v2_compatible__ = true
   return history
 }
-