docs(guide/component-router): initial draft for component router 0.2.0

Closes angular#14131

Author: petebacondarwin

docs/content/guide/component-router.ngdoc

@@ -287,7 +287,7 @@ module.exports = {
   rewrite: function(){
     return function(req, res, next){
       var REWRITE = /\/(guide|api|cookbook|misc|tutorial|error).*$/,
-          IGNORED = /(\.(css|js|png|jpg|gif)$|partials\/.*\.html$)/,
+          IGNORED = /(\.(css|js|png|jpg|gif|svg)$|partials\/.*\.html$)/,
           match;
 
       if (!IGNORED.test(req.url) && (match = req.url.match(REWRITE))) {

docs/img/guide/component-based-architecture.svg

@@ -0,0 +1,111 @@
+/**
+ * @ngdoc module
+ * @name ngComponentRouter
+ * @description
+ * The new Angular Router
+ */
+
+/**
+ * @ngdoc type
+ * @name Router
+ * @description
+ * A `Router` is responsible for mapping URLs to components.
+ *
+ * You can see the state of a router by inspecting the read-only field `router.navigating`.
+ * This may be useful for showing a spinner, for instance.
+ *
+ * ## Concepts
+ *
+ * Routers and "Routed Component" instances have a 1:1 correspondence.
+ *
+ * The router holds reference to a number of Outlets.
+ * An outlet is a placeholder that the router dynamically fills in depending on the current URL.
+ *
+ * When the router navigates from a URL, it must first recognize it and serialize it into an
+ * `Instruction`.
+ * The router uses the `RouteRegistry` to get an `Instruction`.
+ */
+
+/**
+ * @ngdoc type
+ * @name ChildRouter
+ * @description
+ *
+ *
+ */
+
+/**
+ * @ngdoc type
+ * @name ComponentInstruction
+ * @description
+ * A `ComponentInstruction` represents the route state for a single component. An `Instruction` is
+ * composed of a tree of these `ComponentInstruction`s.
+ *
+ * `ComponentInstructions` is a public API. Instances of `ComponentInstruction` are passed
+ * to route lifecycle hooks, like `$routerCanActivate`.
+ *
+ * You should not modify this object. It should be treated as immutable.
+ */
+
+/**
+ * @ngdoc type
+ * @name  RouteDefinition
+ * @description
+ *
+ */
+
+/**
+ * @ngdoc type
+ * @name  RouteParams
+ * @description
+ * `RouteParams` is an immutable map of parameters for the given route
+ * based on the url matcher and optional parameters for that route.
+ *
+ */
+
+/**
+ * @ngdoc directive
+ * @name  ngOutlet
+ * @description
+ *
+ */
+
+/**
+ * @name ngLink
+ * @description
+ * Lets you link to different parts of the app, and automatically generates hrefs.
+ *
+ * ## Use
+ * The directive uses a simple syntax: `ng-link="componentName({ param: paramValue })"`
+ *
+ * ### Example
+ *
+ * ```js
+ * angular.module('myApp', ['ngComponentRouter'])
+ *   .controller('AppController', ['$rootRouter', function($rootRouter) {
+ *     $rootRouter.config({ path: '/user/:id', component: 'user' });
+ *     this.user = { name: 'Brian', id: 123 };
+ *   });
+ * ```
+ *
+ * ```html
+ * <div ng-controller="AppController as app">
+ *   <a ng-link="user({id: app.user.id})">{{app.user.name}}</a>
+ * </div>
+ * ```
+ */
+
+
+/**
+ * @ngdoc service
+ * @name  $rootRouter
+ * @description
+ *
+ */
+
+
+/**
+ * @ngdoc service
+ * @name  $routerRootComponent
+ * @description
+ */