post-review updates

chalin · chalin · commit de8fb3ff2a44 · 2016-08-17T15:59:22.000-07:00
diff --git a/public/docs/dart/latest/glossary.jade b/public/docs/dart/latest/glossary.jade
@@ -5,13 +5,16 @@ block includes
 
 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
+    When unqualified, _annotation_ refers to a Dart [metadata
+    annotation][metadata] (as opposed to, say, a type annotation).  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.
 
+    The corresponding term in TypeScript and JavaScript is
+    [_decorator_](!{docsPath}/ts/latest/glossary.html#decorator).
+
     [metadata]: https://www.dartlang.org/guides/language/language-tour#metadata
 
 block bootstrap-defn-top
@@ -54,3 +57,12 @@ block append snake-case-defn
   :marked
       Library and file names are often spelled in snake_case. Examples include:
       `angular2_tour_of_heroes` and `app_component.dart`.
+
+block zone-defn
+  :marked
+    Zones are a mechanism for encapsulating and intercepting
+    a Dart application's asynchronous activity.
+
+    To learn more, consult the [zones article][zones].
+
+    [zones]: https://www.dartlang.org/articles/libraries/zones
diff --git a/public/docs/ts/_cache/glossary.jade b/public/docs/ts/_cache/glossary.jade
@@ -558,7 +558,7 @@ a#N
   :marked
     A [Provider](!{_ProviderUrl}) creates a new instance of a dependency for the
     [Dependency Injection](#dependency-injection) system.
-    It relates a lookup token to code &mdash; sometimes called a "recipe" &mdash; 
+    It relates a lookup token to code &mdash; sometimes called a "recipe" &mdash;
     that can create a dependency value.
 
 a#Q
@@ -744,8 +744,6 @@ a#snake-case
     TypeScript is the preferred language for Angular 2 development although
     we are welcome to write in other JavaScript dialects such as [ES5](#es5).
 
-    Angular 2 itself is written in TypeScript.
-
     Learn more about TypeScript on its [website](http://www.typescriptlang.org/).
 
 a#U
@@ -775,22 +773,23 @@ a#Y
 :marked
   ## Zone
 .l-sub-section
-  :marked
-    Zones are a mechanism for encapsulating and intercepting
-    a JavaScript application's asynchronous activity.
+  block zone-defn
+    :marked
+      Zones are a mechanism for encapsulating and intercepting
+      a JavaScript application's asynchronous activity.
 
-    The browser DOM and JavaScript have a limited number
-    of asynchronous activities, activities such as DOM events (e.g., clicks),
-    [promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), and
-    [XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest)
-    calls to remote servers.
+      The browser DOM and JavaScript have a limited number
+      of asynchronous activities, activities such as DOM events (e.g., clicks),
+      [promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), and
+      [XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest)
+      calls to remote servers.
 
-    Zones intercept all of these activities and give a "zone client" the opportunity
-    to take action before and after the async activity completes.
+      Zones intercept all of these activities and give a "zone client" the opportunity
+      to take action before and after the async activity completes.
 
-    Angular runs our application in a zone where it can respond to
-    asynchronous events by checking for data changes and updating
-    the information it displays via [data binding](#data-binding).
+      Angular runs our application in a zone where it can respond to
+      asynchronous events by checking for data changes and updating
+      the information it displays via [data bindings](#data-binding).
 
-    Learn more about zones in this
-    [Brian Ford video](https://www.youtube.com/watch?v=3IqtmUscE_U).
+      Learn more about zones in this
+      [Brian Ford video](https://www.youtube.com/watch?v=3IqtmUscE_U).
diff --git a/public/docs/ts/latest/glossary.jade b/public/docs/ts/latest/glossary.jade
@@ -558,7 +558,7 @@ a#N
   :marked
     A [Provider](!{_ProviderUrl}) creates a new instance of a dependency for the
     [Dependency Injection](#dependency-injection) system.
-    It relates a lookup token to code &mdash; sometimes called a "recipe" &mdash; 
+    It relates a lookup token to code &mdash; sometimes called a "recipe" &mdash;
     that can create a dependency value.
 
 a#Q
@@ -744,8 +744,6 @@ a#snake-case
     TypeScript is the preferred language for Angular 2 development although
     we are welcome to write in other JavaScript dialects such as [ES5](#es5).
 
-    Angular 2 itself is written in TypeScript.
-
     Learn more about TypeScript on its [website](http://www.typescriptlang.org/).
 
 a#U
@@ -775,22 +773,23 @@ a#Y
 :marked
   ## Zone
 .l-sub-section
-  :marked
-    Zones are a mechanism for encapsulating and intercepting
-    a JavaScript application's asynchronous activity.
+  block zone-defn
+    :marked
+      Zones are a mechanism for encapsulating and intercepting
+      a JavaScript application's asynchronous activity.
 
-    The browser DOM and JavaScript have a limited number
-    of asynchronous activities, activities such as DOM events (e.g., clicks),
-    [promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), and
-    [XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest)
-    calls to remote servers.
+      The browser DOM and JavaScript have a limited number
+      of asynchronous activities, activities such as DOM events (e.g., clicks),
+      [promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), and
+      [XHR](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest)
+      calls to remote servers.
 
-    Zones intercept all of these activities and give a "zone client" the opportunity
-    to take action before and after the async activity completes.
+      Zones intercept all of these activities and give a "zone client" the opportunity
+      to take action before and after the async activity completes.
 
-    Angular runs our application in a zone where it can respond to
-    asynchronous events by checking for data changes and updating
-    the information it displays via [data binding](#data-binding).
+      Angular runs our application in a zone where it can respond to
+      asynchronous events by checking for data changes and updating
+      the information it displays via [data bindings](#data-binding).
 
-    Learn more about zones in this
-    [Brian Ford video](https://www.youtube.com/watch?v=3IqtmUscE_U).
+      Learn more about zones in this
+      [Brian Ford video](https://www.youtube.com/watch?v=3IqtmUscE_U).
