Merge pull request #40 from plotly/improve-docs

Improving PlotlyViaWindowModule docs

Author: andrefarzat

README.md

@@ -83,6 +83,8 @@ For a full description of Plotly chart types and attributes see the following re
 * [Plotly JavaScript API documentation](https://plot.ly/javascript/)
 * [Full plotly.js attribute listing](https://plot.ly/javascript/reference/)
 
+The `plotly.js` is bundled within the angular code. To avoid this, please read [how to customize the plotlyjs bundle](#customizing-the-plotlyjs-bundle) below.
+
 ## API Reference
 
 ### Basic Props
@@ -172,7 +174,33 @@ export class AppModule { }
 
 ### Plotly Via Window Module
 
-If you want to use a [different precompiled bundle](https://github.com/plotly/plotly.js/blob/master/dist/README.md#partial-bundles) or if you wish to [assemble you own customized bundle](https://github.com/plotly/plotly.js#modules), you can use `PlotlyViaWindowModule` to force the use of `window.Plotly` object. You can add the script via tag `<script>` direct on your code, or add it as a [global script on angular.json](https://github.com/angular/angular-cli/wiki/stories-global-scripts#global-scripts).
+`plotly.js` can be added as a [global script on angular.json](https://github.com/angular/angular-cli/wiki/stories-global-scripts#global-scripts) to avoid it beingb bundled into the final project's code. To make this happen, you must first add `plotly.js` path into `angular.json` file as shown below: 
+
+```javascript
+// angular.json
+{
+    ...
+    "projects": {
+        "project-name": { // This is your project's name
+            ...
+            "architect": {
+                "build": {
+                    ...
+                    "options": {
+                        "scripts": [
+                            "node_modules/plotly.js/dist/plotly.min.js" // add this
+                        ]
+                    }
+                }
+            }
+            ...
+        }
+    }
+}
+```
+
+This will include `plotly.js` into the `vendor.js` file generated by angular CLI build process, and `plotly.js` library will be loaded before angular and your project's code. The `window.Plotly` will be available. Thus, you must use `PlotlyViaWindowModule` module to force `angular-plotly.js` to use `window.Plotly` object:
+
 
 ```typescript
 import { NgModule } from '@angular/core';
@@ -187,6 +215,7 @@ import { PlotlyViaWindowModule } from 'angular-plotly.js';
 export class AppModule { }
 ```
 
+If you want to use a [different precompiled bundle](https://github.com/plotly/plotly.js/blob/master/dist/README.md#partial-bundles) or if you wish to [assemble you own customized bundle](https://github.com/plotly/plotly.js#modules), you can use `PlotlyViaWindowModule` to force the use of `window.Plotly` object as shown above.
 
 ## Development
 
@@ -210,4 +239,4 @@ $ npm run test
 
 ## License
 
-&copy; 2018 Plotly, Inc. MIT License.
+&copy; 2019 Plotly, Inc. MIT License.