docs(glossary): general cleanup and fix links

This commit addresses issues with the glossary for all languages (JS, TS, Dart).

Fixes #1123, #1838, #2036.

This was originally started as post-RC5 Dart resync, but since mixing Harp partials with Jade mixins can be problematic, this commit does a general cleanup of the 3 x 2 = 6 glossary files (found in `{ts,js,dart}/latest/{.,guide}`).

This commit builds upon #2098 (which created the first `ts/_cache` copy of the glossary), but doesn't really depend on it.

Author: chalin

public/docs/dart/latest/glossary.jade

@@ -1,35 +1,56 @@
-include _util-fns
-
-block var-def
-  - var fragPath='../../ts/latest/_fragments/';
-
-!=partial(fragPath + 'glossary-intro')
-!=partial(fragPath + 'glossary-a1')
-!=partial(fragPath + 'glossary-a-2')
-!=partial(fragPath + 'glossary-b-c')
-!=partial(fragPath + 'glossary-d1')
-!=partial(fragPath + 'glossary-d2')
-!=partial(fragPath + 'glossary-e1')
-!=partial(fragPath + 'glossary-e2')
-!=partial(fragPath + 'glossary-f-l')
-!=partial(fragPath + 'glossary-m1')
-//partial(fragPath + 'glossary-m2') not needed in dart
-!=partial(fragPath + 'glossary-n-s-1')
-
-:marked
-  ## snake_case
-
-.l-sub-section
+extends ../../ts/_cache/glossary.jade
+
+block includes
+  include _util-fns
+
+block annotation-defn
+  :marked
+    There are different kinds of annotation in Dart. Unqualified use of the
+    term usually refers to a [_metadata_ annotation][metadata]. A metadata
+    annotation begins with the character `@`, followed by either a reference
+    to a compile-time constant (such as [`Component`](#component)) or a call
+    to a constant constructor. See the [Dart Language Guide][metadata] for
+    details.
+
+    [metadata]: https://www.dartlang.org/guides/language/language-tour#metadata
+
+block bootstrap-defn-top
+  :marked
+    We launch an Angular application by "bootstrapping" it with the
+    [bootstrap][bootstrap] method.  The `bootstrap` method identifies an
+    application's top level "root" [Component](#component) and optionally
+    registers service [providers](#provider) with the [dependency injection
+    system](#dependency-injection).
+
+    [bootstrap]: !{docsLatest}/api/angular2.platform.browser/bootstrap.html
+
+block decorator-defn
+  :marked
+    When used in this guide, these JavaScript terms are taken as synonymous with
+    [annotation](#annotation).
+
+block module-defn
+  //- Taken from the Dart Difference in guide/architecture.jade
+  :marked
+    In this guide, the term _module_ refers to a Dart compilation unit, such
+    as a library, or a package. (If a Dart file has no `library` or `part`
+    directive, then that file itself is a library and thus a compilation
+    unit.) For more information about compilation units, see
+    the chapter on "Libraries and Scripts" in the
+    [Dart Language Specification](https://www.dartlang.org/docs/spec/).
+
+block routing-component-defn
+  :marked
+    A [Component](#component) with an attached router.
+
+    In most cases, the component became attached to a [router](#router) by means
+    of a `@RouterConfig` #{decorator} that defined routes to views controlled by this component.
+
+    The component's template has a `RouterOutlet` element where it can display views produced by the router.
+
+    It likely has anchor tags or buttons with `RouterLink` directives that users can click to navigate.
+
+block append snake-case-defn
   :marked
-    The practice of writing compound words or phrases such that each word is separated by an
-    underscore (`_`).
-    
-    Library and file names are often spelled in snake_case. Examples include:
-    `angular2_tour_of_heroes` and `app_component.dart`.
-    
-    This form is also known as **underscore case**.
-
-!=partial(fragPath + 'glossary-n-s-2')
-!=partial(fragPath + 'glossary-t1')
-//partial(fragPath + 'glossary-t2') notneeded in dart
-!=partial(fragPath + 'glossary-u-z')
+      Library and file names are often spelled in snake_case. Examples include:
+      `angular2_tour_of_heroes` and `app_component.dart`.

public/docs/dart/latest/guide/glossary.jade

@@ -1,4 +1,4 @@
 extends ../glossary
 
 block var-def
-  - var fragPath='../../../ts/latest/_fragments/';
+  include ../_util-fns

public/docs/js/latest/glossary.jade

@@ -1,35 +1,12 @@
-include _util-fns
-// From ts/glossary.jade, the folder ts/latest/_fragments is generated which contains a bunch of partial files.
-// These partials comprise the glossary,a subset of these partials should be used to generate the glossary for
-// __javascript__ under BASICS.
-!=partial('../../ts/latest/_fragments/glossary-intro')
-//!=partial('../../ts/latest/_fragments/glossary-a-1') not needed in javascript
-!=partial('../../ts/latest/_fragments/glossary-a-2')
-!=partial('../../ts/latest/_fragments/glossary-b-c')
-!=partial('../../ts/latest/_fragments/glossary-d1')
-!=partial('../../ts/latest/_fragments/glossary-d2')
-!=partial('../../ts/latest/_fragments/glossary-e1')
-!=partial('../../ts/latest/_fragments/glossary-e2')
-!=partial('../../ts/latest/_fragments/glossary-f-l')
-!=partial('../../ts/latest/_fragments/glossary-m1')
-!=partial('../../ts/latest/_fragments/glossary-m2')
-!=partial('../../ts/latest/_fragments/glossary-n-s')
-!=partial('../../ts/latest/_fragments/glossary-t1')
-!=partial('../../ts/latest/_fragments/glossary-t2')
-!=partial('../../ts/latest/_fragments/glossary-u-z')
+extends ../../ts/latest/glossary.jade
 
-// NOTE: (ericjim): I am almost certain these lines are doing nothing,
-// so instead I use `!=partial` to include the glossary fragments.
-//+includeShared('{ts}', 'intro')
-//+includeShared('{ts}', 'a2')
-//+includeShared('{ts}', 'b-c')
-//+includeShared('{ts}', 'd1')
-//+includeShared('{ts}', 'd2')
-//+includeShared('{ts}', 'e1')
-//+includeShared('{ts}', 'e2')
-//+includeShared('{ts}', 'f-l')
-//+includeShared('{ts}', 'm1')
-//+includeShared('{ts}', 'n-s')
-//+includeShared('{ts}', 't1')
-//+includeShared('{ts}', 't2')
-//+includeShared('{ts}', 'u-z')
+block includes
+  include _util-fns
+
+block bootstrap-defn-top
+  :marked
+    We launch an Angular application by "bootstrapping" it with the
+    `bootstrap` method.  The `bootstrap` method identifies an
+    application's top level "root" [Component](#component) and optionally
+    registers service [providers](#provider) with the [dependency injection
+    system](#dependency-injection).

public/docs/js/latest/guide/glossary.jade

@@ -1 +1,4 @@
-!= partial("../glossary")
+extends ../glossary
+
+block var-def
+  include ../_util-fns