api-builder: improve "not yet documented" handling

* All export members are now tagged if they have no documentation.
* All exports are tagged if they and their members have no documentation.
* The templates for these docs display the words "Not Yet Documented" if they are tagged.
* The build creates a warning for each export that is not documented
* The build generates a new file, `public/docs/ts/latest/api/overview-dump.html`, which
lists all the modules, exports and members highlighting those that are not documented.

tools/api-builder/angular.io-package/index.js

@@ -58,7 +58,6 @@ module.exports = new Package('angular.io', [basePackage, targetPackage, cheatshe
 .config(function(readFilesProcessor, generateNavigationDoc, createOverviewDump) {
   // Clear out unwanted processors
   generateNavigationDoc.$enabled = false;
-  //createOverviewDump.$enabled = false;
 })
 
 

tools/api-builder/angular.io-package/templates/class.template.html

@@ -47,7 +47,11 @@ p.location-badge.
         code.
           {$ doc.constructorDoc.name $}{$ paramList(doc.constructorDoc.parameters) | indent(8, false) | trim $}
     :marked
+      {%- if doc.constructorDoc.notYetDocumented %}
+      *Not Yet Documented*
+      {% else %}
 {$ doc.constructorDoc.description | indentForMarkdown(6) | replace('## Example', '') | replace('# Example', '') | trimBlankLines $}
+      {% endif -%}
 {% endif -%}
 
 {%- for member in doc.members %}{% if not member.internal %}
@@ -58,8 +62,11 @@ p.location-badge.
           {$ member.name $}{$ paramList(member.parameters) | indent(8, false) | trim $}{$ returnType(member.returnType) $}
 
     :marked
+      {%- if member.notYetDocumented %}
+        *Not Yet Documented*
+      {% else %}
 {$ member.description | indentForMarkdown(6) | replace('## Example', '') | replace('# Example', '') | trimBlankLines $}
-
+      {% endif %}
 {% endif %}{% endfor %}
 {%- endif -%}
 

tools/api-builder/angular.io-package/templates/function.template.html

@@ -15,6 +15,9 @@ include ../../_util-fns
     defined in {$ githubViewLink(doc) $}
 
   :marked
+{%- if doc.notYetDocumented %}
+  *Not Yet Documented*
+{% else %}
 {$ doc.description | indentForMarkdown(4) | trimBlankLines $}
-
+{% endif %}
 {% endblock %}

tools/api-builder/angular.io-package/templates/var.template.html

@@ -16,7 +16,7 @@ include ../../_util-fns
 
   :marked
 {%- if doc.notYetDocumented %}
-    ### *Not Yet Documented*
+  *Not Yet Documented*
 {% else %}
 {$ doc.description | indentForMarkdown(4) | trimBlankLines $}
 {% endif -%}