docs(aio): update headers for toc

aio/content/guide/ajs-quick-reference.md

@@ -1,10 +1,4 @@
-@title
-AngularJS to Angular Quick Reference
-
-@intro
-Learn how AngularJS concepts and techniques map to Angular.
-
-@description
+# AngularJS to Angular Quick Reference
 
 
 {@a top}
@@ -19,21 +13,6 @@ by mapping AngularJS syntax to the equivalent Angular syntax.
 
 **See the Angular syntax in this <live-example name="ajs-quick-reference"></live-example>**.
 
-<!--
-## Contents
-
-* [Template basics](guide/ajs-quick-reference#template-basics)&mdash;binding and local variables.
-
-* [Template directives](guide/ajs-quick-reference#template-directives)&mdash;built-in directives `ngIf` and `ngClass`.
-
-* [Filters/pipes](guide/ajs-quick-reference#filters-pipes)&mdash;built-in *filters*, known as *pipes* in Angular.
-
-* [Modules/controllers/components](guide/ajs-quick-reference#controllers-components)&mdash;*modules* in Angular are slightly different from *modules* in AngularJS, and *controllers* are *components* in Angular.
-
-* [Style sheets](guide/ajs-quick-reference#style-sheets)&mdash;more options for CSS than in AngularJS.
--->
-
-
 ## Template basics
 Templates are the user-facing part of an Angular application and are written in HTML.
 The following table lists some of the key AngularJS template features with their equivalent Angular template syntax.

aio/content/guide/animations.md

@@ -22,21 +22,6 @@ add it to your page.
 
 </div>
 
-<!--
-# Contents
-
-* [Example: Transitioning between two states](guide/animations#example-transitioning-between-states).
-* [States and transitions](guide/animations#states-and-transitions).
-* [Example: Entering and leaving](guide/animations#example-entering-and-leaving).
-* [Example: Entering and leaving from different states](guide/animations#example-entering-and-leaving-from-different-states).
-* [Animatable properties and units](guide/animations#animatable-properties-and-units).
-* [Automatic property calculation](guide/animations#automatic-property-calculation).
-* [Animation timing](guide/animations#animation-timing).
-* [Multi-step animations with keyframes](guide/animations#multi-step-animations-with-keyframes).
-* [Parallel animation groups](guide/animations#parallel-animation-groups).
-* [Animation callbacks](guide/animations#animation-callbacks).
--->
-
 <div class="l-sub-section">
 
 The examples in this page are available as a <live-example></live-example>.

aio/content/guide/aot-compiler.md

@@ -1,40 +1,8 @@
-@title
-Ahead-of-Time Compilation
-
-@intro
-Learn how to use ahead-of-time compilation.
-
-@description
+# Ahead-of-Time Compilation
 
 This cookbook describes how to radically improve performance by compiling _ahead-of-time_ (AOT)
 during a build process.
 
-{@a toc}
-<!--
-# Contents
-
-* [Overview](guide/aot-compiler#overview)
-* [Ahead-of-time (AOT) vs just-in-time (JIT)](guide/aot-compiler#aot-jit)
-* [Why do AOT compilation?](guide/aot-compiler#why-aot)
-* [Compile with AOT](guide/aot-compiler#compile)
-* [Bootstrap](guide/aot-compiler#bootstrap)
-* [Tree shaking](guide/aot-compiler#tree-shaking)
-  * [Rollup](guide/aot-compiler#rollup)
-  * [Rollup Plugins](guide/aot-compiler#rollup-plugins)
-  * [Run Rollup](guide/aot-compiler#run-rollup)
-* [Load the bundle](guide/aot-compiler#load)
-* [Serve the app](guide/aot-compiler#serve)
-* [AOT QuickStart source code](guide/aot-compiler#source-code)
-* [Workflow and convenience script](guide/aot-compiler#workflow)
-  * [Develop JIT along with AOT](guide/aot-compiler#run-jit)
-* [Tour of Heroes](guide/aot-compiler#toh)
-  * [JIT in development, AOT in production](guide/aot-compiler#jit-dev-aot-prod)
-  * [Tree shaking](guide/aot-compiler#shaking)
-  * [Running the application](guide/aot-compiler#running-app)
-  * [Inspect the Bundle](guide/aot-compiler#inspect-bundle)
-
--->
-
 {@a overview}
 
 ## Overview

aio/content/guide/appmodule.md

@@ -1,11 +1,4 @@
-@title
-AppModule: the root module
-
-@intro
-Tell Angular how to construct and bootstrap the app in the root "AppModule".
-
-@description
-
+# AppModule: the root module
 
 An Angular module class describes how the application parts fit together.
 Every application has at least one Angular module, the _root_ module 
@@ -193,4 +186,4 @@ As your app grows, you'll consider subdividing it into multiple "feature" module
 some of which can be loaded later ("lazy loaded") if and when the user chooses
 to visit those features.
 
-When you're ready to explore these possibilities, visit the [Angular Modules (NgModule)](guide/ngmodule) guide.
+When you're ready to explore these possibilities, visit the [Angular Modules (NgModule)](guide/ngmodule) guide.

aio/content/guide/attribute-directives.md

@@ -2,18 +2,6 @@
 
 An **Attribute** directive changes the appearance or behavior of a DOM element.
 
-<!--
-# Contents
-
-* [Directives overview](guide/attribute-directives#directive-overview)
-* [Build a simple attribute directive](guide/attribute-directives#write-directive)
-* [Apply the attribute directive to an element in a template](guide/attribute-directives#apply-directive)
-* [Respond to user-initiated events](guide/attribute-directives#respond-to-user)
-* [Pass values into the directive with an _@Input_ data binding](guide/attribute-directives#bindings)
-* [Bind to a second property](guide/attribute-directives#second-property)
-
--->
-
 Try the <live-example title="Attribute Directive example"></live-example>.
 
 {@a directive-overview}
@@ -136,7 +124,7 @@ Now when the app runs, the `myHighlight` directive highlights the paragraph text
 
 <div class="l-sub-section">
 
-### Your directive isn't working?
+<h3 class="no-toc">Your directive isn't working?</h3>
 
 Did you remember to add the directive to the `declarations` attribute of `@NgModule`?
 It is easy to forget!

aio/content/guide/browser-support.md

@@ -1,12 +1,4 @@
-@title
-Browser support
-
-@intro
-Browser support and polyfills guide.
-
-@description
-
-
+# Browser support
 
 Angular supports most recent browsers. This includes the following specific versions:
 

aio/content/guide/change-log.md

@@ -1,10 +1,4 @@
-@title
-Change Log
-
-@intro
-An annotated history of recent documentation improvements.
-
-@description
+# Change Log
 
 
 

aio/content/guide/cheatsheet.md

@@ -1,7 +1,4 @@
-@title
-Cheat Sheet
-
-@description
+# Cheat Sheet
 
 <div id="cheatsheet">
 <table class="is-full-width is-fixed-layout">
@@ -387,4 +384,4 @@ so the <code>@Directive</code> configuration applies to components as well</p>
 </td>
 </tr>
 </tbody></table>
-</div>
+</div>

aio/content/guide/cli-quickstart.md

@@ -1,8 +1,4 @@
-@title
-CLI QuickStart
-
-@description
-
+# CLI QuickStart
 
 Good tools make application development quicker and easier to maintain than
 if you did everything by hand.

aio/content/guide/component-interaction.md

@@ -1,10 +1,5 @@
-@title
-Component Interaction
+# Component Interaction
 
-@intro
-Share information between different directives and components.
-
-@description
 {@a top}
 
 This cookbook contains recipes for common component communication scenarios

aio/content/guide/dependency-injection-in-action.md

@@ -1,10 +1,4 @@
-@title
-Dependency Injection
-
-@intro
-Techniques for Dependency Injection.
-
-@description
+# Dependency Injection
 
 
 Dependency Injection is a powerful pattern for managing code dependencies.

aio/content/guide/dependency-injection.md

@@ -1,12 +1,4 @@
-@title
-Dependency Injection
-
-@intro
-Angular's dependency injection system creates and delivers dependent services "just-in-time".
-
-@description
-
-
+# Dependency Injection
 
 **Dependency injection** is an important application design pattern.
 Angular has its own dependency injection framework, and
@@ -16,45 +8,6 @@ It's used so widely that almost everyone just calls it _DI_.
 This page covers what DI is, why it's so useful,
 and [how to use it](guide/dependency-injection#angular-di) in an Angular app.
 
-<!--
-
-# Contents
-
-* [Why dependency injection?](guide/dependency-injection#why-di)
-* [Angular dependency injection](guide/dependency-injection#angular-dependency-injection)
-
-  * [Configuring the injector](guide/dependency-injection#injector-config)
-  * [Registering providers in an `NgModule`](guide/dependency-injection#register-providers-ngmodule)
-  * [Registering providers in a component](guide/dependency-injection#register-providers-component)
-  * [When to use `NgModule` versus an application component](guide/dependency-injection#ngmodule-vs-comp)
-  * [Preparing the `HeroListComponent` for injection](guide/dependency-injection#prep-for-injection)
-  * [Implicit injector creation](guide/dependency-injection#di-metadata)
-  * [Singleton services](guide/dependency-injection#singleton-services)
-  * [Testing the component](guide/dependency-injection#testing-the-component)
-  * [When the service needs a service](guide/dependency-injection#service-needs-service)
-  * [Why `@Injectable()`?](guide/dependency-injection#injectable)
-
-* [Creating and registering a logger service](guide/dependency-injection#logger-service)
-* [Injector providers](guide/dependency-injection#injector-providers)
-
-  * [The `Provider` class and `provide` object literal](guide/dependency-injection#provide)
-  * [Alternative class providers](guide/dependency-injection#class-provider)
-  * [Class provider with dependencies](guide/dependency-injection#class-provider-dependencies)
-  * [Aliased class providers](guide/dependency-injection#aliased-class-providers)
-  * [Value providers](guide/dependency-injection#value-provider)
-  * [Factory providers](guide/dependency-injection#factory-provider)
-
-* [Dependency injection tokens](guide/dependency-injection#dependency-injection-tokens)
-
-  * [Non-class dependencies](guide/dependency-injection#non-class-dependencies)
-  * [`InjectionToken`](guide/dependency-injection#injection-token)
-
-* [Optional dependencies](guide/dependency-injection#optional)
-* [Summary](guide/dependency-injection#summary)
-* [Appendix: Working with injectors directly](guide/dependency-injection#explicit-injector)
-
--->
-
 Run the <live-example></live-example>.
 
 {@a why-di }

aio/content/guide/deployment.md

@@ -1,39 +1,10 @@
-@title
-Deployment
-
-@intro
-Learn how to deploy your Angular app.
-
-@description
-
+# Deployment
 
 This page describes tools and techniques for deploy and optimize your Angular application.
 
 
 {@a toc}
 
-<!--
-
-## Table of contents
-
-* [Overview](guide/deployment#overview)
-* [Simplest deployment possible](guide/deployment#dev-deploy)
-* [Optimize for production](guide/deployment#optimize)
-  * [Ahead-of-Time (AOT) compilation](guide/deployment#aot)
-  * [Webpack](guide/deployment#webpack)
-  * [Tree shaking with _rollup_](guide/deployment#rollup)
-  * [Pruned libraries](guide/deployment#prune)
-  * [Measure performance first](guide/deployment#measure)
-* [Angular configuration](guide/deployment#angular-configuration)
-  * [The `base` tag](guide/deployment#base-tag)
-  * [Enable production mode](guide/deployment#enable-prod-mode)
-  * [Lazy loading](guide/deployment#lazy-loading)
-* [Server configuration](guide/deployment#server-configuration)
-  * [Routed apps must fallback to `index.html`](guide/deployment#fallback)
-  * [CORS: requesting services from a different server](guide/deployment#cors)
-
--->
-
 {@a overview}
 
 

aio/content/guide/displaying-data.md

@@ -1,12 +1,4 @@
-@title
-Displaying Data
-
-@intro
-Property binding helps show app data in the UI.
-
-@description
-
-
+# Displaying Data
 
 You can display data by binding controls in an HTML template to properties of an Angular component.
 
@@ -21,16 +13,6 @@ The final UI looks like this:
   <img src="generated/images/guide/displaying-data/final.png" alt="Final UI">
 </figure>
 
-<!--
-
-# Contents
-
-* [Showing component properties with interpolation](guide/displaying-data#interpolation).
-* [Showing an array property with NgFor](guide/displaying-data#ngFor).
-* [Conditional display with NgIf](guide/displaying-data#ngIf).
-
--->
-
 <div class="l-sub-section">
 
 
@@ -282,7 +264,7 @@ That brief syntax does a lot:
 
 
 
-## Using the Hero class
+### Using the Hero class
 
 After importing the `Hero` class, the `AppComponent.heroes` property can return a _typed_ array
 of `Hero` objects:

aio/content/guide/dynamic-form.md

@@ -1,10 +1,4 @@
-@title
-Dynamic Forms
-
-@intro
-Render dynamic forms with FormGroup.
-
-@description
+# Dynamic Forms
 
 {@a top}
 
@@ -27,17 +21,6 @@ The agency is constantly tinkering with the application process.
 You can create the forms on the fly *without changing the application code*.
 {@a toc}
 
-<!--
-
-# Contents
- * [Bootstrap](guide/dynamic-form#bootstrap)
- * [Question model](guide/dynamic-form#object-model)
- * [Question form components](guide/dynamic-form#form-component)
- * [Questionnaire data](guide/dynamic-form#questionnaire-data)
- * [Dynamic template](guide/dynamic-form#dynamic-template)
-
--->
-
 See the <live-example name="dynamic-form"></live-example>.
 
 {@a bootstrap}