docs(glossary): copyedits and dropped unused Dart blocks (#3455)

* docs(glossary): copyedits and dropped unused Dart blocks
* post-review updates

cc @kapunahelewong @kwalrath
This commit is contained in:
Patrice Chalin 2017-03-29 16:05:39 -07:00 committed by Ward Bell
parent a5a55eabe1
commit 53d94a8723

View File

@ -46,11 +46,9 @@ a#aot
For details and examples, see the [Angular Modules (NgModule)](!{docsLatest}/guide/ngmodule.html) page.
+ifDocsFor('ts|dart')
:marked
:marked
## Annotation
.l-sub-section
block annotation-defn
.l-sub-section
:marked
In practice, a synonym for [Decoration](#decorator).
@ -120,16 +118,16 @@ a#attribute-directives
Sometimes refers to a [dependency-injection](#dependency-injection) binding
between a "token"—also referred to as a "key"—and a dependency [provider](#provider).
When using this more rare usage, be clear in context.
:marked
## Bootstrap
.l-sub-section
block bootstrap-defn-top
:marked
You launch an Angular application by "bootstrapping" it using the application root Angular module (`AppModule`). Bootstrapping identifies an application's top level "root" [component](#component), which is the first component that is loaded for the application.
You launch an Angular application by "bootstrapping" it using the application root Angular module (`AppModule`).
Bootstrapping identifies an application's top level "root" [component](#component),
which is the first component that is loaded for the application.
For more information, see the [Setup](!{docsLatest}/guide/setup.html) page.
:marked
You can bootstrap multiple apps in the same `index.html`, each app with its own top-level root.
.l-main-section#C
@ -200,14 +198,11 @@ a#component
* [Style binding](!{docsLatest}/guide/template-syntax.html#style-binding).
* [Two-way data binding with ngModel](!{docsLatest}/guide/template-syntax.html#ngModel).
+ifDocsFor('ts|dart')
a#decorator
a#decoration
:marked
a#decorator
a#decoration
:marked
## Decorator | decoration
.l-sub-section
block decorator-defn
.l-sub-section
:marked
A *function* that adds metadata to a class, its members (properties, methods) and function arguments.
@ -296,7 +291,7 @@ a#directives
An Angular class responsible for creating, reshaping, and interacting with HTML elements
in the browser DOM. The directive is Angular's most fundamental feature.
A directive is ususally associated with an HTML element or attribute.
A directive is usually associated with an HTML element or attribute.
This element or attribute is often referred to as the directive itself.
When Angular finds a directive in an HTML template,
@ -308,22 +303,20 @@ a#directives
as if you were writing native HTML. In this way, directives become extensions of
HTML itself.
Directives fall into one of the following categories:
* [Components](#component) combine application logic with an HTML template to
render application [views](#view). Components are usually represented as HTML elements.
They are the building blocks of an Angular application.
1. [Attribute directives](#attribute-directive) can listen to and modify the behavior of
* [Attribute directives](#attribute-directive) can listen to and modify the behavior of
other HTML elements, attributes, properties, and components. They are usually represented
as HTML attributes, hence the name.
1. [Structural directives](#structural-directive) are responsible for
* [Structural directives](#structural-directive) are responsible for
shaping or reshaping HTML layout, typically by adding, removing, or manipulating
elements and their children.
.l-main-section#E
:marked
@ -449,7 +442,6 @@ a#jit
:marked
## Module
.l-sub-section
block module-defn
.alert.is-important
:marked
Angular has the following types of modules:
@ -492,7 +484,7 @@ a#N
:marked
An array whose items arrive asynchronously over time.
Observables help you manage asynchronous data, such as data coming from a backend service.
Observables are used within Angular itself, including Angular's event system and its http client service.
Observables are used within Angular itself, including Angular's event system and its HTTP client service.
To use observables, Angular uses a third-party library called Reactive Extensions (RxJS).
Observables are a proposed feature for ES2016, the next version of JavaScript.
@ -548,10 +540,9 @@ a#N
a#Q
.l-main-section#R
+ifDocsFor('ts|js')
:marked
:marked
## Reactive forms
.l-sub-section
.l-sub-section
:marked
A technique for building Angular forms through code in a component.
The alternative technique is [template-driven forms](#template-driven-forms).
@ -588,10 +579,9 @@ a#Q
For more information, see the [Routing & Navigation](!{docsLatest}/guide/router.html) page.
+ifDocsFor('ts|js')
:marked
:marked
## Router module
.l-sub-section
.l-sub-section
:marked
A separate [Angular module](#angular-module) that provides the necessary service providers and directives for navigating through application views.
@ -607,10 +597,9 @@ a#Q
.l-main-section#S
+ifDocsFor('ts|js')
:marked
:marked
## Scoped package
.l-sub-section
.l-sub-section
:marked
A way to group related *npm* packages.
Read more at the [npm-scope](https://docs.npmjs.com/misc/scope) page.
@ -645,9 +634,7 @@ a#Q
a#snake-case
:marked
## snake_case
.l-sub-section
block snake-case-defn
:marked
The practice of writing compound words or phrases such that an
underscore (`_`) separates one word from the next. This form is also known as *underscore case*.
@ -663,7 +650,7 @@ a#structural-directives
shape or reshape HTML layout, typically by adding and removing elements in the DOM.
The `ngIf` "conditional element" directive and the `ngFor` "repeater" directive are well-known examples.
Read more in the [_Structural Directives_](!{docsLatest}/guide/structural-directives.html) guide.
Read more in the [Structural Directives](!{docsLatest}/guide/structural-directives.html) page.
.l-main-section#T
:marked
@ -674,11 +661,9 @@ a#structural-directives
the support and guidance of an Angular [directive](#directive),
most notably a [component](#component).
+ifDocsFor('ts|js')
:marked
:marked
## Template-driven forms
.l-sub-section
.l-sub-section
:marked
A technique for building Angular forms using HTML forms and input elements in the view.
The alternate technique is [Reactive Forms](#reactive-forms).
@ -756,7 +741,6 @@ a#Y
:marked
## Zone
.l-sub-section
block zone-defn
:marked
A mechanism for encapsulating and intercepting
a JavaScript application's asynchronous activity.