update documentation

Author: guybedford

README.md

@@ -1,32 +1,30 @@
 # ES6 Module Loader Polyfill [![Build Status][travis-image]][travis-url]
 
-_For upgrading to ES6 Module Loader 0.16, [read the release notes here](https://github.com/ModuleLoader/es6-module-loader/releases/tag/v0.16.0)._
+_For upgrading to ES6 Module Loader 0.17, [read the release notes here](https://github.com/ModuleLoader/es6-module-loader/releases/tag/v0.17.0)._
 
 Dynamically loads ES6 modules in browsers and [NodeJS](#nodejs-use) with support for loading existing and custom module formats through loader hooks.
 
 This project implements dynamic module loading through `System` exactly to the previous ES6-specified loader API at [2014-08-24 ES6 Specification Draft Rev 27, Section 15](http://wiki.ecmascript.org/doku.php?id=harmony:specification_drafts#august_24_2014_draft_rev_27). The new loader implementing the [WhatWG loader spec](https://github.com/whatwg/loader) is pending alpha release on the [1.0 branch](https://github.com/ModuleLoader/es6-module-loader/tree/1.0).
 
 * Provides an asynchronous loader (`System.import`) to [dynamically load ES6 modules](#getting-started).
 * Supports [Traceur](https://github.com/google/traceur-compiler), [Babel](http://babeljs.io/) and [TypeScript](https://github.com/Microsoft/TypeScript/) for compiling ES6 modules and syntax into ES5 in the browser with source map support.
-* Fully supports [ES6 circular references and live bindings](https://github.com/ModuleLoader/es6-module-loader/wiki/Circular-References-&-Bindings).
-* Includes [`baseURL` and `paths` implementations](https://github.com/ModuleLoader/es6-module-loader/wiki/Configuring-the-Loader).
-* Can be used as a [tracing tool](https://github.com/ModuleLoader/es6-module-loader/wiki/Tracing-API) for static analysis of modules.
-* Polyfills ES6 Promises in the browser with an optionally bundled ES6 promise implementation.
+* Fully supports [ES6 circular references and live bindings](docs/circular-references-bindings.md).
+* Includes [`baseURL` and `paths` implementations](docs/Configuring-the-Loader.md).
+* Can be used as a [tracing tool](docs/tracing-api.md) for static analysis of modules.
 * Supports IE8+, with IE9+ support for ES6 development without pre-compilation.
-* The complete combined polyfill, including ES6 promises, comes to 9KB minified and gzipped, making it suitable for production use, provided that modules are [built into ES5 making them independent of Traceur](https://github.com/ModuleLoader/es6-module-loader/wiki/Production-Workflows).
+* The minified production loader is under 5KB minified and gzipped, making it suitable for production use, provided that modules are [built into ES5 making them independent of Traceur](docs/production-workflows.md).
 
-For an overview of build workflows, [see the production guide](https://github.com/ModuleLoader/es6-module-loader/wiki/Production-Workflows).
+For an overview of build workflows, [see the production guide](docs/production-workflows.md).
 
 For an example of a universal module loader based on this polyfill for loading AMD, CommonJS and globals, see [SystemJS](https://github.com/systemjs/systemjs).
 
 ### Documentation
 
-* [A brief overview of ES6 module syntax](https://github.com/ModuleLoader/es6-module-loader/wiki/Brief-Overview-of-ES6-Module-syntax)
-* [Configuring the loader](https://github.com/ModuleLoader/es6-module-loader/wiki/Configuring-the-Loader)
-* [Production workflows](https://github.com/ModuleLoader/es6-module-loader/wiki/Production-Workflows)
-* [Circular References & Bindings](https://github.com/ModuleLoader/es6-module-loader/wiki/Circular-References-&-Bindings)
-* [Extending the loader through loader hooks](https://github.com/ModuleLoader/es6-module-loader/wiki/Extending-the-ES6-Loader)
-* [Tracing API](https://github.com/ModuleLoader/es6-module-loader/wiki/Tracing-API)
+* [Configuring the loader](docs/loader-config.md)
+* [Production workflows](docs/production-workflows.md)
+* [Circular References & Bindings](docs/circular-references-bindings.md)
+* [Extending the loader through loader hooks](docs/loader-extensions.md)
+* [Tracing API](docs/tracing-api.md)
 
 ### Getting Started
 

docs/circular-references-bindings.md

@@ -2,20 +2,25 @@
 
 #### Zebra-Striping
 
-All [AMD](http://requirejs.org/docs/api.html#circular), [CommonJS](http://nodejs.org/api/modules.html#modules_cycles), and [ES6](https://github.com/ModuleLoader/es6-module-loader#circular-references--bindings) treat circular dependencies differently. 
-Handling this problem is one of the innovations of the loader spec, using a technique called **zebra-striping**. This involves analyzing the dependency tree and forming alternate layers of ES6 / non-ES6 modules with circular references in each layer for linking.
-The layers are then individually linked, with the appropriate circular reference handling being done within each layer. This allows CommonJS circular references to interact with ES6 circular references. Inter-format circular references are not supported as they
-would be across layers.
+All [AMD](http://requirejs.org/docs/api.html#circular), [CommonJS](http://nodejs.org/api/modules.html#modules_cycles), 
+and [ES6](https://github.com/ModuleLoader/es6-module-loader#circular-references--bindings) treat circular dependencies differently. 
+Handling this problem is one of the innovations of the loader spec, using a technique called **zebra-striping**. 
+This involves analyzing the dependency tree and forming alternate layers of ES6 / non-ES6 modules with circular 
+references in each layer for linking. The layers are then individually linked, with the appropriate circular reference 
+handling being done within each layer. This allows CommonJS circular references to interact with ES6 circular references. 
+Inter-format circular references are not supported as they would be across layers.
 
-This loader implementation handles zebra-striping automatically, allowing a loader like [SystemJS](https://github.com/systemjs/systemjs) to support all module formats with exact circular reference support.
+This loader implementation handles zebra-striping automatically, allowing a loader like [SystemJS](https://github.com/systemjs/systemjs)
+to support all module formats with exact circular reference support.
 
 #### ES6 Circular References & Bindings
 
 ES6 circular references and bindings behave in the following way:
 
 * Bindings are set up before module execution.
 * Execution is run from depth-first left to right on the module tree stopping at circular references.
-* Bindings are live - an adjustment to an export of one module affects all modules importing it, but it can only be modified in the defining module.
+* Bindings are live - an adjustment to an export of one module affects all modules importing it, but it can 
+only be modified in the defining module.
 
 even.js
 ```javascript

docs/loader-config.md

@@ -1,16 +1,3 @@
-### baseURL
-
-All modules are loaded relative to the `baseURL`, which by default is set to the current page path.
-
-We can alter this with:
-
-```javascript
-  System.baseURL = '/js/lib/';
-  System.import('module'); // now loads "/js/lib/module.js"
-```
-
-> Note that using `System.import` to load URLs is not currently supported, instead use paths for this as documented below.
-
 ### Paths Implementation
 
 The System loader provides paths rules used by the standard `locate` function.
@@ -26,8 +13,6 @@ For example, we might want to load `jquery` from a CDN location. For this we can
 
 Any reference to `jquery` in other modules will also use this same version.
 
-**Be careful**：When developing, System loader uses xhr method to load script from CDN site, so there might be some Cross-Origin problems.
-
 It is also possible to define wildcard paths rules. The most specific rule will be used:
 
 ```javascript
@@ -53,12 +38,18 @@ or if using Babel:
 System.babelOptions = { experimental: true };
 ```
 
+or TypeScript:
+
+```javascript
+System.typescriptOptions = {};
+```
+
 ### Finding the Transpiler
 
 For Babel use the `browser.js` file contained in the `babel-core` npm module. For Traceur use the `traceur.js` file contained in the `traceur` npm module bin folder.
 
 The transpiler is loaded as a module itself, so will follow normal paths rules.
-
+> 
 To set custom paths to Babel or Traceur use paths configuration:
 
 ```javascript
@@ -70,4 +61,6 @@ Alternatively if you know that the transpiler will be needed, it will be detecte
 ```html
 <script src="traceur.js"></script>
 <script src="es6-module-loader.js"></script>
-```
+```
+
+> TypeScript can be loaded in the browser, but in Node, must already be defined as a global before loading an ES6 file.

docs/loader-extensions.md

@@ -1,9 +1,9 @@
 ### Extending the ES6 Loader
 
-The ES6 specification defines a loader through five hooks:
+The loader pipeline is based on the following hooks:
 
-* Normalize: Given the import name, provide the canonical module name.
-* Locate: Given a canonical module name, provide the URL for the resource.
+* Normalize: Given the import name, provide the normalized name for the resource.
+* Locate: Given a normalized module name, provide the URL for the resource.
 * Fetch: Given a URL for a resource, fetch its content.
 * Translate: Given module source, make any source modifications.
 * Instantiate: Given module source, determine its dependencies, and how to execute it.
@@ -123,6 +123,5 @@ function instantiate(load) {
 
 For a more in-depth overview of creating with custom loaders, some resources are provided below:
 
-* The [System Loader implementation](https://github.com/ModuleLoader/es6-module-loader/blob/master/src/loader.js#L867)
 * [ES6 Loader API guide](https://gist.github.com/dherman/7568080)
 * [Yehuda Katz's essay](https://gist.github.com/wycats/51c96e3adcdb3a68cbc3) (outdated)

docs/overview.md

@@ -4,12 +4,12 @@ When in production, it is not suitable to load ES6 modules and syntax in the bro
 
 #### System.register Output
 
-There is a `modules=instantiate` build output in Traceur and `modules=system` output in Babel that can be used with the ES6 Module Loader, provided it has the [System.register extension](https://github.com/systemjs/systemjs/blob/master/lib/extension-register.js)
-from [SystemJS](https://github.com/systemjs/systemjs).
+There is a `modules=instantiate` build output in Traceur and `modules=system` output in Babel and TypeScript that can be used with the ES6 Module Loader, 
+provided it has been extended with support for the System.register format.
 
-The benefit of this output is that it provides full support for circular references and live module bindings.
+This is available from the [system-register-only](https://github.com/systemjs/systemjs/tree/v0.17.0/dist) SystemJS build of the loader.
 
-[This output format is explained here](system-register.md)
+The benefit of the [System.register output format](system-register.md) is that it provides [full support for circular references and live module bindings](circular-references-bindings.md).
 
 A basic example of using this extension with a Traceur build would be the following (although the related similar workflow would apply for Babel):
 
@@ -23,19 +23,7 @@ A basic example of using this extension with a Traceur build would be the follow
 
   ```html
     <script src="traceur-runtime.js"></script>
-    <script src="es6-module-loader.js"></script>
-    <script>
-      /*
-       * This should be a separate external script
-       * Register function is included from https://github.com/systemjs/systemjs/blob/master/lib/extension-register.js
-       */
-      function register(loader) { 
-        // ...
-      }
-
-      // this needs to be added to apply the extension
-      register(System);
-    </script>
+    <script src="system-register-only.js"></script>
 
     <!-- now include the bundle -->
     <script src="app-build.js"></script>
@@ -57,10 +45,10 @@ We can also build separate files with:
   traceur --dir app app-build --modules=instantiate
 ```
 
-With the above, we can load from the separate files identical to loading ES6.
+With the above, we can load from the separate files identical to loading ES6, but with full CSP compatibility.
 
 #### Building across module formats
 
 If using a loader like [SystemJS](https://github.com/systemjs/systemjs) to load different module formats, then a build can also be performed across module formats as well.
 
-See [SystemJS builder](https://github.com/systemjs/builder) for this combined approach.
+See [SystemJS builder](https://github.com/systemjs/builder) for a combined approach.