chore(doc-gen): ensure all public exports are rendered in public_docs

Closes angular#1222

Author: petebacondarwin

docs/app/css/app.css

@@ -374,6 +374,6 @@ md-content.demo-source-container > hljs > pre > code.highlight {
   margin: 1em 0;
 }
 
-.member {
-
+.left-nav {
+  min-width: 300px;
 }

docs/app/index.html

@@ -28,7 +28,7 @@ <h1 class="md-toolbar-tools">Angular V2</h1>
 
   <section layout="row">
 
-    <md-content>
+    <md-content class="left-nav">
       <h2>Navigation</h2>
       <section ng-repeat="area in nav.areas">
         <h3>{{ area.name }}</h3>

docs/dgeni-package/templates/class.template.html

@@ -3,7 +3,8 @@
 
 {% block body %}
 <h1 class="class export">{$ doc.name $} <span class="type">class</span></h1>
-<p class="module">exported from <a href="/{$ doc.moduleDoc.path $}">{$ doc.moduleDoc.id $}</a></p>
+<p class="module">exported from <a href="/{$ doc.moduleDoc.path $}">{$ doc.moduleDoc.id $}</a><br/>
+defined in <a href="https://github.com/angular/angular/tree/master/modules/{$ doc.location.start.source.name $}.js#L{$ doc.location.start.line $}">{$ doc.location.start.source.name $}.js (line {$ doc.location.start.line $})</a></p>
 <p>{$ doc.description | marked $}</p>
 
 {%- if doc.constructorDoc or doc.members.length -%}

docs/dgeni-package/templates/module.template.html

@@ -9,7 +9,7 @@ <h1 class="id">{$ doc.id $} <span class="type">module</span></h1>
 <h2>Exports</h2>
 <ul>
 {%- for exportDoc in doc.exports %}
-  <li><a href="/{$ exportDoc.path $}">{$ exportDoc.name $} {$ exportDoc.docType $}</a></li>
+  <li><a href="/{$ exportDoc.path $}"><strong>{$ exportDoc.name $}</strong> {$ exportDoc.docType $}</a></li>
 {%- endfor %}
 </ul>
 {% endif %}

docs/public-docs-package/processors/filterPublicDocs.js

@@ -10,42 +10,54 @@ module.exports = function filterPublicDocs(modules) {
     },
     $process: function(docs) {
 
+      var extraPublicDocs = [];
       docTypes = this.docTypes;
 
+      _.forEach(docs, function(doc) {
 
-      docs = _.filter(docs, function(doc) {
+        if (docTypes.indexOf(doc.docType) === -1 || !doc.publicModule) return;
+
+        var publicModule = modules[doc.publicModule];
 
-        if (docTypes.indexOf(doc.docType) === -1) return true;
-        if (!doc.publicModule) return false;
+        if (!publicModule) {
+          throw new Error('Missing module definition: "' + doc.publicModule + '"\n' +
+                          'Referenced in class: "' + doc.moduleDoc.id + '/' + doc.name + '"');
+        } else {
 
-        updateModule(doc);
+          // Ensure module is marked as public
+          publicModule.isPublic = true;
 
-        return true;
+          // Add a clone of export to its "public" module
+          var publicDoc = _.clone(doc);
+          publicDoc.moduleDoc = publicModule;
+          publicModule.exports.push(publicDoc);
+          extraPublicDocs.push(publicDoc);
+        }
       });
 
+      // Filter out the documents that are not public
       docs = _.filter(docs, function(doc) {
-        return doc.docType !== 'module' || doc.isPublic;
-      });
-      return docs;
-    }
-  };
 
+        if (doc.docType === 'module') {
+          // doc is a module - is it public?
+          return doc.isPublic;
+        }
 
-  function updateModule(classDoc) {
+        if (docTypes.indexOf(doc.docType) === -1) {
+          // doc is not a type we care about
+          return true;
+        }
 
-    var originalModule = classDoc.moduleDoc;
-    var publicModule = modules[classDoc.publicModule];
+        // doc is in a public module
+        return doc.moduleDoc && doc.moduleDoc.isPublic;
 
-    if (!publicModule) {
-      throw new Error('Missing module definition: "' + classDoc.publicModule + '"\n' +
-                      'Referenced in class: "' + classDoc.moduleDoc.id + '/' + classDoc.name + '"');
-    }
+      });
+
+      docs = docs.concat(extraPublicDocs);
 
-    publicModule.isPublic = true;
+      return docs;
+    }
+  };
 
-    _.remove(classDoc.moduleDoc.exports, function(doc) { return doc === classDoc; });
-    classDoc.moduleDoc = publicModule;
-    publicModule.exports.push(classDoc);
 
-  }
 };