Skip to content
This repository was archived by the owner on Apr 12, 2024. It is now read-only.

Commit d0ceeaa

Browse files
samilamtipetebacondarwin
authored andcommitted
docs(guide/Introduction): define CRUD and add punctuation
Added description of what CRUD means. Improved readability: Ensured that colons were followed by a capital letter and added some sprinkled commas. Closes #10804
1 parent 301663e commit d0ceeaa

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

docs/content/guide/introduction.ngdoc

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ succinctly. Angular's data binding and dependency injection eliminate much of th
1212
would otherwise have to write. And it all happens within the browser, making it
1313
an ideal partner with any server technology.
1414

15-
Angular is what HTML would have been had it been designed for applications. HTML is a great
15+
Angular is what HTML would have been, had it been designed for applications. HTML is a great
1616
declarative language for static documents. It does not contain much in the way of creating
1717
applications, and as a result building web applications is an exercise in *what do I have to do
1818
to trick the browser into doing what I want?*
@@ -28,10 +28,10 @@ The impedance mismatch between dynamic applications and static documents is ofte
2828

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

3333
* Data binding, as in `{{}}`.
34-
* DOM control structures for repeating/hiding DOM fragments.
34+
* DOM control structures for repeating, showing and hiding DOM fragments.
3535
* Support for forms and form validation.
3636
* Attaching new behavior to DOM elements, such as DOM event handling.
3737
* Grouping of HTML into reusable components.
@@ -42,20 +42,20 @@ browser new syntax through a construct we call directives. Examples include:
4242

4343
Angular is not a single piece in the overall puzzle of building the client-side of a web
4444
application. It handles all of the DOM and AJAX glue code you once wrote by hand and puts it in a
45-
well-defined structure. This makes Angular opinionated about how a CRUD application should be
46-
built. But while it is opinionated, it also tries to make sure that its opinion is just a
47-
starting point you can easily change. Angular comes with the following out-of-the-box:
45+
well-defined structure. This makes Angular opinionated about how a CRUD (Create, Read, Update, Delete)
46+
application should be built. But while it is opinionated, it also tries to make sure that its opinion
47+
is just a starting point you can easily change. Angular comes with the following out-of-the-box:
4848

49-
* Everything you need to build a CRUD app in a cohesive set: data-binding, basic templating
50-
directives, form validation, routing, deep-linking, reusable components, dependency injection.
51-
* Testability story: unit-testing, end-to-end testing, mocks, test harnesses.
49+
* Everything you need to build a CRUD app in a cohesive set: Data-binding, basic templating
50+
directives, form validation, routing, deep-linking, reusable components and dependency injection.
51+
* Testability story: Unit-testing, end-to-end testing, mocks and test harnesses.
5252
* Seed application with directory layout and test scripts as a starting point.
5353

5454

55-
## Angular Sweet Spot
55+
## Angular's sweet spot
5656

5757
Angular simplifies application development by presenting a higher level of abstraction to the
58-
developer. Like any abstraction, it comes at a cost of flexibility. In other words not every app
58+
developer. Like any abstraction, it comes at a cost of flexibility. In other words, not every app
5959
is a good fit for Angular. Angular was built with the CRUD application in mind. Luckily CRUD
6060
applications represent the majority of web applications. To understand what Angular is
6161
good at, though, it helps to understand when an app is not a good fit for Angular.
@@ -78,7 +78,7 @@ expressing business logic.
7878
* It is an excellent idea to decouple the client side of an app from the server side. This
7979
allows development work to progress in parallel, and allows for reuse of both sides.
8080
* It is very helpful indeed if the framework guides developers through the entire journey of
81-
building an app: from designing the UI, through writing the business logic, to testing.
81+
building an app: From designing the UI, through writing the business logic, to testing.
8282
* It is always good to make common tasks trivial and difficult tasks possible.
8383

8484

0 commit comments

Comments
 (0)