diff --git a/aio/content/guide/architecture-modules.md b/aio/content/guide/architecture-modules.md index f43c5d71c1..0c0cab7d5d 100644 --- a/aio/content/guide/architecture-modules.md +++ b/aio/content/guide/architecture-modules.md @@ -17,7 +17,7 @@ An NgModule is defined by a class decorated with `@NgModule()`. The `@NgModule() * `imports`: Other modules whose exported classes are needed by component templates declared in *this* NgModule. -* `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, which is often preferred.) +* `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.) * `bootstrap`: The main application view, called the *root component*, which hosts all other app views. Only the *root NgModule* should set the `bootstrap` property. diff --git a/aio/content/guide/bootstrapping.md b/aio/content/guide/bootstrapping.md index 2b5dd9d4db..d0faf6d0df 100644 --- a/aio/content/guide/bootstrapping.md +++ b/aio/content/guide/bootstrapping.md @@ -12,7 +12,7 @@ Every application has at least one Angular module, the _root_ module, which must be present for bootstrapping the application on launch. By convention and by default, this NgModule is named `AppModule`. -When you use the [Angular CLI](cli) command `ng new` to generate an app, the default `AppModule` is as follows. +When you use the [Angular CLI](cli) command `ng new` to generate an app, the default `AppModule` looks like the following: ```typescript /* JavaScript imports */ @@ -90,8 +90,6 @@ A declarable can only belong to one module, so only declare it in one `@NgModule`. When you need it elsewhere, import the module that has the declarable you need in it. -**Only `@NgModule` references** go in the `imports` array. - ### Using directives with `@NgModule` @@ -133,7 +131,7 @@ The module's `imports` array appears exclusively in the `@NgModule` metadata obj It tells Angular about other NgModules that this particular module needs to function properly. This list of modules are those that export components, directives, or pipes -that the component templates in this module reference. In this case, the component is +that component templates in this module reference. In this case, the component is `AppComponent`, which references components, directives, or pipes in `BrowserModule`, `FormsModule`, or `HttpClientModule`. A component template can reference another component, directive, diff --git a/aio/content/guide/feature-modules.md b/aio/content/guide/feature-modules.md index 0b8d5d137f..961c791580 100644 --- a/aio/content/guide/feature-modules.md +++ b/aio/content/guide/feature-modules.md @@ -79,7 +79,7 @@ To incorporate the feature module into your app, you have to let the root module -Now the `AppModule` knows about the feature module. If you were to add any service providers to the feature module, `AppModule` would know about those too, as would any other feature modules. However, NgModules don’t expose their components. +Now the `AppModule` knows about the feature module. If you were to add any service providers to the feature module, `AppModule` would know about those too, as would any other feature modules. However, NgModules don’t expose their components by default. ## Rendering a feature module’s component template diff --git a/aio/content/guide/ngmodule-faq.md b/aio/content/guide/ngmodule-faq.md index cc9c858776..d8ccf16490 100644 --- a/aio/content/guide/ngmodule-faq.md +++ b/aio/content/guide/ngmodule-faq.md @@ -101,7 +101,7 @@ should import `BrowserModule` from `@angular/platform-browser`. `BrowserModule` provides services that are essential to launch and run a browser app. `BrowserModule` also re-exports `CommonModule` from `@angular/common`, -which means that components in the `AppModule` module also have access to +which means that components in the `AppModule` also have access to the Angular directives every app needs, such as `NgIf` and `NgFor`. Do not import `BrowserModule` in any other module. @@ -140,7 +140,7 @@ declared in this NgModule. You _can_ export any declarable class—components, directives, and pipes—whether it's declared in this NgModule or in an imported NgModule. -You _can_ re-export entire imported NgModules, which effectively re-exports all of their exported classes. +You _can_ re-export entire imported NgModules, which effectively re-export all of their exported classes. An NgModule can even export a module that it doesn't import.
@@ -192,7 +192,7 @@ Its only purpose is to add http service providers to the application as a whole. The `forRoot()` static method is a convention that makes it easy for developers to configure services and providers that are intended to be singletons. A good example of `forRoot()` is the `RouterModule.forRoot()` method. -Apps pass a `Routes` object to `RouterModule.forRoot()` in order to configure the app-wide `Router` service with routes. +Apps pass a `Routes` array to `RouterModule.forRoot()` in order to configure the app-wide `Router` service with routes. `RouterModule.forRoot()` returns a [ModuleWithProviders](api/core/ModuleWithProviders). You add that result to the `imports` list of the root `AppModule`. diff --git a/aio/content/guide/ngmodules.md b/aio/content/guide/ngmodules.md index 04a3c69dd2..c51846ffd1 100644 --- a/aio/content/guide/ngmodules.md +++ b/aio/content/guide/ngmodules.md @@ -36,7 +36,7 @@ NgModule metadata does the following: * Declares which components, directives, and pipes belong to the module. * Makes some of those components, directives, and pipes public so that other module's component templates can use them. * Imports other modules with the components, directives, and pipes that components in the current module need. -* Provides services that the other application components can use. +* Provides services that other application components can use. Every Angular app has at least one module, the root module. You [bootstrap](guide/bootstrapping) that module to launch the application.