Skip to content

Commit c6fa3b0

Browse files
adamshaylorpetebacondarwin
authored andcommitted
docs(overview.ngdoc): clarify wording
1 parent b6a0777 commit c6fa3b0

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

docs/content/guide/overview.ngdoc

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -8,42 +8,42 @@
88
AngularJS is a structural framework for dynamic web apps. It lets you use HTML as your template
99
language and lets you extend HTML's syntax to express your application's components clearly and
1010
succinctly. Out of the box, it eliminates much of the code you currently write through data
11-
binding and dependency injection. And it all happens in JavaScript within the browser making it an
12-
ideal partner with any server technology.
11+
binding and dependency injection. And it all happens in JavaScript within the browser, making it
12+
an ideal partner with any server technology.
1313

1414
Angular is what HTML would have been had it been designed for applications. HTML is a great
1515
declarative language for static documents. It does not contain much in the way of creating
16-
applications, and as a result building web applications is an exercise in *what do I have to do, so
17-
that I trick the browser in to doing what I want.*
16+
applications, and as a result building web applications is an exercise in *what do I have to do
17+
to trick the browser into doing what I want.*
1818

19-
The impedance mismatch between dynamic applications and static documents is often solved as:
19+
The impedance mismatch between dynamic applications and static documents is often solved with:
2020

21-
* **library** - a collection of functions which are useful when writing web apps. Your code is
21+
* **a library** - a collection of functions which are useful when writing web apps. Your code is
2222
in charge and it calls into the library when it sees fit. E.g., `jQuery`.
2323
* **frameworks** - a particular implementation of a web application, where your code fills in
2424
the details. The framework is in charge and it calls into your code when it needs something
25-
app specific. E.g., `knockout`, `sproutcore`, etc.
25+
app specific. E.g., `knockout`, `ember`, etc.
2626

2727

2828
Angular takes another approach. It attempts to minimize the impedance mismatch between document
2929
centric HTML and what an application needs by creating new HTML constructs. Angular teaches the
3030
browser new syntax through a construct we call directives. Examples include:
3131

32-
* Data binding as in `{{}}`.
32+
* Data binding, as in `{{}}`.
3333
* DOM control structures for repeating/hiding DOM fragments.
3434
* Support for forms and form validation.
3535
* Attaching code-behind to DOM elements.
3636
* Grouping of HTML into reusable components.
3737

3838

3939

40-
## End-to-end solution
40+
## A complete client-side solution
4141

42-
Angular tries to be an end-to-end solution, when building a web application. This means it is
43-
not a single piece in an overall puzzle of building a web application, but an end-to-end solution.
44-
This makes Angular opinionated about how a CRUD application should be built. But while it is
45-
opinionated, it also tries to make sure that its opinion is just a starting point, which you can
46-
easily change. Angular comes with the following out-of-the-box:
42+
Angular is not a single piece in the overall puzzle of building the client-side of a web
43+
application. It handles all of the DOM and AJAX glue code you once wrote by hand and puts it in a
44+
well-defined structure. This makes Angular opinionated about how a CRUD application should be
45+
built. But while it is opinionated, it also tries to make sure that its opinion is just a
46+
starting point you can easily change. Angular comes with the following out-of-the-box:
4747

4848
* Everything you need to build a CRUD app in a cohesive set: data-binding, basic templating
4949
directives, form validation, routing, deep-linking, reusable components, dependency injection.

0 commit comments

Comments
 (0)