Skip to content

Commit 4cd2cc4

Browse files
TeriGloverAndrewKushnir
authored andcommitted
docs: Edits to remove jargon in Reference section (angular#42033)
PR Close angular#42033
1 parent ee0e3fb commit 4cd2cc4

10 files changed

+55
-55
lines changed

aio/content/guide/architecture-components.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
A *component* controls a patch of screen called a [*view*](guide/glossary#view "Definition of view").
44
For example, individual components define and control each of the following views from the [Tour of Heroes tutorial](tutorial):
55

6-
* The app root with the navigation links.
6+
* The application root with the navigation links.
77
* The list of heroes.
88
* The hero editor.
99

@@ -17,7 +17,7 @@ The service is provided to the component through the dependency injection system
1717

1818
<code-example path="architecture/src/app/hero-list.component.ts" header="src/app/hero-list.component.ts (class)" region="class"></code-example>
1919

20-
Angular creates, updates, and destroys components as the user moves through the application. Your app can take action at each moment in this lifecycle through optional [lifecycle hooks](guide/lifecycle-hooks), like `ngOnInit()`.
20+
Angular creates, updates, and destroys components as the user moves through the application. Your application can take action at each moment in this lifecycle through optional [lifecycle hooks](guide/lifecycle-hooks), like `ngOnInit()`.
2121

2222
## Component metadata
2323

@@ -35,7 +35,7 @@ Here's an example of basic metadata for `HeroListComponent`.
3535

3636
This example shows some of the most useful `@Component` configuration options:
3737

38-
* `selector`: A CSS selector that tells Angular to create and insert an instance of this component wherever it finds the corresponding tag in template HTML. For example, if an app's HTML contains `<app-hero-list></app-hero-list>`, then
38+
* `selector`: A CSS selector that tells Angular to create and insert an instance of this component wherever it finds the corresponding tag in template HTML. For example, if an application's HTML contains `<app-hero-list></app-hero-list>`, then
3939
Angular inserts an instance of the `HeroListComponent` view between those tags.
4040

4141
* `templateUrl`: The module-relative address of this component's HTML template. Alternatively, you can provide the HTML template inline, as the value of the `template` property. This template defines the component's *host view*.
@@ -59,7 +59,7 @@ A view hierarchy can include views from components in the same NgModule, but it
5959

6060
## Template syntax
6161

62-
A template looks like regular HTML, except that it also contains Angular [template syntax](guide/template-syntax), which alters the HTML based on your app's logic and the state of app and DOM data. Your template can use *data binding* to coordinate the app and DOM data, *pipes* to transform data before it is displayed, and *directives* to apply app logic to what gets displayed.
62+
A template looks like regular HTML, except that it also contains Angular [template syntax](guide/template-syntax), which alters the HTML based on your application's logic and the state of application and DOM data. Your template can use *data binding* to coordinate the application and DOM data, *pipes* to transform data before it is displayed, and *directives* to apply application logic to what gets displayed.
6363

6464
For example, here is a template for the Tutorial's `HeroListComponent`.
6565

aio/content/guide/architecture-modules.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
# Introduction to modules
22

3-
Angular apps are modular and Angular has its own modularity system called *NgModules*.
3+
Angular applications are modular and Angular has its own modularity system called *NgModules*.
44
NgModules are containers for a cohesive block of code dedicated to an application domain, a workflow, or a closely related set of capabilities. They can contain components, service providers, and other code files whose scope is defined by the containing NgModule. They can import functionality that is exported from other NgModules, and export selected functionality for use by other NgModules.
55

6-
Every Angular app has at least one NgModule class, [the *root module*](guide/bootstrapping), which is conventionally named `AppModule` and resides in a file named `app.module.ts`. You launch your app by *bootstrapping* the root NgModule.
6+
Every Angular application has at least one NgModule class, [the *root module*](guide/bootstrapping), which is conventionally named `AppModule` and resides in a file named `app.module.ts`. You launch your application by *bootstrapping* the root NgModule.
77

8-
While a small application might have only one NgModule, most apps have many more *feature modules*. The *root* NgModule for an app is so named because it can include child NgModules in a hierarchy of any depth.
8+
While a small application might have only one NgModule, most applications have many more *feature modules*. The *root* NgModule for an application is so named because it can include child NgModules in a hierarchy of any depth.
99

1010
## NgModule metadata
1111

@@ -17,9 +17,9 @@ An NgModule is defined by a class decorated with `@NgModule()`. The `@NgModule()
1717

1818
* `imports`: Other modules whose exported classes are needed by component templates declared in *this* NgModule.
1919

20-
* `providers`: Creators of [services](guide/architecture-services) that this NgModule contributes to the global collection of services; they become accessible in all parts of the app. (You can also specify providers at the component level.)
20+
* `providers`: Creators of [services](guide/architecture-services) that this NgModule contributes to the global collection of services; they become accessible in all parts of the application. (You can also specify providers at the component level.)
2121

22-
* `bootstrap`: The main application view, called the *root component*, which hosts all other app views. Only the *root NgModule* should set the `bootstrap` property.
22+
* `bootstrap`: The main application view, called the *root component*, which hosts all other application views. Only the *root NgModule* should set the `bootstrap` property.
2323

2424
Here's a simple root NgModule definition.
2525

@@ -53,13 +53,13 @@ When you create a component, it's associated directly with a single view, called
5353

5454
<div class="alert is-helpful">
5555

56-
**Note:** The hierarchical structure of views is a key factor in the way Angular detects and responds to changes in the DOM and app data.
56+
**Note:** The hierarchical structure of views is a key factor in the way Angular detects and responds to changes in the DOM and application data.
5757

5858
</div>
5959

6060
## NgModules and JavaScript modules
6161

62-
The NgModule system is different from and unrelated to the JavaScript (ES2015) module system for managing collections of JavaScript objects. These are *complementary* module systems that you can use together to write your apps.
62+
The NgModule system is different from and unrelated to the JavaScript (ES2015) module system for managing collections of JavaScript objects. These are *complementary* module systems that you can use together to write your applications.
6363

6464
In JavaScript each *file* is a module and all objects defined in the file belong to that module.
6565
The module declares some objects to be public by marking them with the `export` key word.

aio/content/guide/architecture-next-steps.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,15 @@ about the features and tools that can help you develop and deliver Angular appli
1515

1616
* The [NgModules](guide/ngmodules) guide provides in-depth information on the modular structure of an Angular application.
1717

18-
* The [Routing and navigation](guide/router) guide provides in-depth information on how to construct applications that allow a user to navigate to different [views](guide/glossary#view) within your single-page app.
18+
* The [Routing and navigation](guide/router) guide provides in-depth information on how to construct applications that allow a user to navigate to different [views](guide/glossary#view) within your single-page application.
1919

2020
* The [Dependency injection](guide/dependency-injection) guide provides in-depth information on how to construct an application such that each component class can acquire the services and objects it needs to perform its function.
2121

2222
## Responsive programming
2323

2424
The [template syntax](guide/template-syntax) and related topics contain details about how to display your component data when and where you want it within a view, and how to collect input from users that you can respond to.
2525

26-
Additional pages and sections describe some basic programming techniques for Angular apps.
26+
Additional pages and sections describe some basic programming techniques for Angular applications.
2727

2828
* [Lifecycle hooks](guide/lifecycle-hooks): Tap into key moments in the lifetime of a component, from its creation to its destruction, by implementing the lifecycle hook interfaces.
2929

@@ -38,13 +38,13 @@ without deep knowledge of animation techniques or CSS.
3838

3939
## Client-server interaction
4040

41-
Angular provides a framework for single-page apps, where most of the logic and data resides on the client.
42-
Most apps still need to access a server using the `HttpClient` to access and save data.
41+
Angular provides a framework for single-page applications, where most of the logic and data resides on the client.
42+
Most applications still need to access a server using the `HttpClient` to access and save data.
4343
For some platforms and applications, you might also want to use the PWA (Progressive Web App) model to improve the user experience.
4444

4545
* [HTTP](guide/http): Communicate with a server to get data, save data, and invoke server-side actions with an HTTP client.
4646

47-
* [Server-side rendering](guide/universal): Angular Universal generates static application pages on the server through server-side rendering (SSR). This allows you to run your Angular app on the server in order to improve performance and show the first page quickly on mobile and low-powered devices, and also facilitate web crawlers.
47+
* [Server-side rendering](guide/universal): Angular Universal generates static application pages on the server through server-side rendering (SSR). This allows you to run your Angular application on the server in order to improve performance and show the first page quickly on mobile and low-powered devices, and also facilitate web crawlers.
4848

4949
* [Service workers and PWA](guide/service-worker-intro): Use a service worker to reduce dependency on the network and significantly improve the user experience.
5050

@@ -60,23 +60,23 @@ For some platforms and applications, you might also want to use the PWA (Progres
6060

6161
* [Deployment](guide/deployment): Learn techniques for deploying your Angular application to a remote server.
6262

63-
* [Security guidelines](guide/security): Learn about Angular's built-in protections against common web-app vulnerabilities and attacks such as cross-site scripting attacks.
63+
* [Security guidelines](guide/security): Learn about Angular's built-in protections against common web-application vulnerabilities and attacks such as cross-site scripting attacks.
6464

65-
* [Internationalization](guide/i18n): Make your app available in multiple languages with Angular's internationalization (i18n) tools.
65+
* [Internationalization](guide/i18n): Make your application available in multiple languages with Angular's internationalization (i18n) tools.
6666

67-
* [Accessibility](guide/accessibility): Make your app accessible to all users.
67+
* [Accessibility](guide/accessibility): Make your application accessible to all users.
6868

6969
## File structure, configuration, and dependencies
7070

7171
* [Workspace and file structure](guide/file-structure): Understand the structure of Angular workspace and project folders.
7272

7373
* [Building and serving](guide/build): Learn to define different build and proxy server configurations for your project, such as development, staging, and production.
7474

75-
* [npm packages](guide/npm-packages): The Angular Framework, Angular CLI, and components used by Angular applications are packaged as [npm](https://docs.npmjs.com/) packages and distributed via the npm registry. The Angular CLI creates a default `package.json` file, which specifies a starter set of packages that work well together and jointly support many common application scenarios.
75+
* [npm packages](guide/npm-packages): The Angular Framework, Angular CLI, and components used by Angular applications are packaged as [npm](https://docs.npmjs.com/) packages and distributed using the npm registry. The Angular CLI creates a default `package.json` file, which specifies a starter set of packages that work well together and jointly support many common application scenarios.
7676

7777
* [TypeScript configuration](guide/typescript-configuration): TypeScript is the primary language for Angular application development.
7878

79-
* [Browser support](guide/browser-support): Make your apps compatible across a wide range of browsers.
79+
* [Browser support](guide/browser-support): Make your applications compatible across a wide range of browsers.
8080

8181
## Extending Angular
8282

aio/content/guide/architecture-services.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Introduction to services and dependency injection
22

3-
*Service* is a broad category encompassing any value, function, or feature that an app needs.
3+
*Service* is a broad category encompassing any value, function, or feature that an application needs.
44
A service is typically a class with a narrow, well-defined purpose.
55
It should do something specific and do it well.
66

@@ -17,7 +17,7 @@ A component can delegate certain tasks to services, such as fetching data from t
1717
validating user input, or logging directly to the console.
1818
By defining such processing tasks in an *injectable service class*, you make those tasks
1919
available to any component.
20-
You can also make your app more adaptable by injecting different providers of the same kind of service,
20+
You can also make your application more adaptable by injecting different providers of the same kind of service,
2121
as appropriate in different circumstances.
2222

2323
Angular doesn't *enforce* these principles. Angular does help you *follow* these principles
@@ -50,7 +50,7 @@ Similarly, use the `@Injectable()` decorator to indicate that a component or oth
5050

5151
* A *provider* is an object that tells an injector how to obtain or create a dependency.
5252

53-
For any dependency that you need in your app, you must register a provider with the app's injector,
53+
For any dependency that you need in your app, you must register a provider with the application's injector,
5454
so that the injector can use the provider to create new instances.
5555
For a service, the provider is typically the service class itself.
5656

@@ -93,7 +93,7 @@ or in the `@NgModule()` or `@Component()` metadata
9393
When you provide the service at the root level, Angular creates a single, shared instance of `HeroService`
9494
and injects it into any class that asks for it.
9595
Registering the provider in the `@Injectable()` metadata also allows Angular to optimize an app
96-
by removing the service from the compiled app if it isn't used, a process known as *tree-shaking*.
96+
by removing the service from the compiled application if it isn't used, a process known as *tree-shaking*.
9797

9898
* When you register a provider with a [specific NgModule](guide/architecture-modules), the same instance of a service is available to all components in that NgModule. To register at this level, use the `providers` property of the `@NgModule()` decorator.
9999

0 commit comments

Comments
 (0)