From ed4d96f858da3abe35386b8ef80039867fdbe6b9 Mon Sep 17 00:00:00 2001 From: Kara Erickson Date: Tue, 22 Oct 2019 18:26:47 -0700 Subject: [PATCH] docs: add migrating to version 9 guide (#33339) This commit adds a guide to AIO navigation for "Migrating to Version 9" and moves the schematics section into the guide that previously lived in the deprecations page. It also pastes a snippet of the deprecations page in the new guide so users don't have to filter out deprecations they've seen before. Note: Ivy compatibility section is coming up in a follow-up PR. PR Close #33339 --- .github/CODEOWNERS | 1 + aio/content/guide/deprecations.md | 39 -------------------- aio/content/guide/updating-to-version-9.md | 43 ++++++++++++++++++++++ aio/content/navigation.json | 5 +++ 4 files changed, 49 insertions(+), 39 deletions(-) create mode 100644 aio/content/guide/updating-to-version-9.md diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 86c818b5e4..3220cc99a5 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -888,6 +888,7 @@ testing/** @angular/fw-test /aio/content/guide/migration-localize.md @angular/fw-docs-packaging @angular/framework-global-approvers @angular/framework-global-approvers-for-docs-only-changes /aio/content/guide/migration-module-with-providers.md @angular/fw-docs-packaging @angular/framework-global-approvers @angular/framework-global-approvers-for-docs-only-changes /aio/content/guide/migration-ngcc.md @angular/fw-docs-packaging @angular/framework-global-approvers @angular/framework-global-approvers-for-docs-only-changes +/aio/content/guide/updating-to-version-9.md @angular/fw-docs-packaging @angular/framework-global-approvers @angular/framework-global-approvers-for-docs-only-changes # ================================================ diff --git a/aio/content/guide/deprecations.md b/aio/content/guide/deprecations.md index 08a48ff90f..c039418f01 100644 --- a/aio/content/guide/deprecations.md +++ b/aio/content/guide/deprecations.md @@ -393,45 +393,6 @@ export class MyModule { } ``` - -## Angular version 9 schematics - -{@a renderer-to-renderer2} -### Migrating from `Renderer` to `Renderer2` - -See the [dedicated migration guide for Renderer](guide/migration-renderer). - -{@a undecorated-classes} -### Migrating undecorated classes - -See the [dedicated migration guide for undecorated classes](guide/migration-undecorated-classes). - -{@a injectable} -### Adding missing `@Injectable()` decorators - -See the [dedicated migration guide for adding missing `@Injectable` decorators](guide/migration-injectable). - -{@a flag-migration} -### Migrating dynamic queries - - See the [dedicated migration guide for dynamic queries](guide/migration-dynamic-flag). - -{@a localize-migration} -### Migrating to the new `$localize` i18n support - - See the [dedicated migration guide for `$localize`](guide/migration-localize). - -{@a module-with-providers} -### Migrating `ModuleWithProviders` - - See the [dedicated migration guide for `ModuleWithProviders`](guide/migration-module-with-providers). -{@a ngcc-migration} -### Migrating to `ngcc` npm `postinstall` script - - See the [dedicated migration guide for `ngcc` npm `postinstall` script](guide/migration-ngcc). - - - {@a removed} ## Removed APIs diff --git a/aio/content/guide/updating-to-version-9.md b/aio/content/guide/updating-to-version-9.md new file mode 100644 index 0000000000..a320a95065 --- /dev/null +++ b/aio/content/guide/updating-to-version-9.md @@ -0,0 +1,43 @@ +# Updating to Angular Version 9 + +This guide contains everything you need to know about updating to the next Angular version. + +## Version 9 Schematics + +If your application uses the CLI, you can update to version 9 automatically with the help of the `ng update` script. +The script will run a series of small migrations that will transform the code of your application to be compatible with version 9. + +If you're curious about the specific migrations being run (e.g. what code is changing and why), the guides below provide more context on each change and contain FAQs for common questions. + +- [Migrating from `Renderer` to `Renderer2`](guide/migration-renderer) +- [Migrating undecorated classes](guide/migration-undecorated-classes) +- [Migrating missing `@Injectable()` decorators](guide/migration-injectable) +- [Migrating dynamic queries](guide/migration-dynamic-flag) +- [Migrating to the new `$localize` i18n support](guide/migration-localize) +- [Migrating `ModuleWithProviders`](guide/migration-module-with-providers) +- [Migrating to `ngcc` npm `postinstall` script](guide/migration-ngcc) + +## Deprecations and Removals in Version 9 + +### New Deprecations + +| API | Replacement | Deprecation announced | Notes | +| ------------------------------------------------------------------------| ------------------------------------ | --------------------- | ----- | +| [`entryComponents`](api/core/NgModule#entryComponents) | none | v9 | See [`entryComponents`](guide/deprecations#entryComponents) | +| [`ANALYZE_FOR_ENTRY_COMPONENTS`](api/core/ANALYZE_FOR_ENTRY_COMPONENTS) | none | v9 | See [`ANALYZE_FOR_ENTRY_COMPONENTS`](guide/deprecations#entryComponents) | +| `ModuleWithProviders` without a generic | `ModuleWithProviders` with a generic | v9 | See [`ModuleWithProviders` section](guide/deprecations#moduleWithProviders) | + +### New Removals of Deprecated APIs + +| Package | API | Replacement | Notes | +| ------- | -------------- | ----------- | ----- | +| `@angular/core` | [`Renderer`](https://v8.angular.io/api/core/Renderer) | [`Renderer2`](https://angular.io/api/core/Renderer2) | [Migration guide.](guide/migration-renderer) +| `@angular/core` | [`RootRenderer`](https://v8.angular.io/api/core/RootRenderer) | [`RendererFactory2`](https://angular.io/api/core/RendererFactory2) | none +| `@angular/core` | [`RenderComponentType`](https://v8.angular.io/api/core/RenderComponentType) | [`RendererType2`](https://angular.io/api/core/RendererType2) | none +| `@angular/common` | `DeprecatedI18NPipesModule` | [`CommonModule`](api/common/CommonModule#pipes) | none | +| `@angular/common` | `DeprecatedCurrencyPipe` | [`CurrencyPipe`](api/common/CurrencyPipe) | none | +| `@angular/common` | `DeprecatedDatePipe` | [`DatePipe`](api/common/DatePipe) | none | +| `@angular/common` | `DeprecatedDecimalPipe` | [`DecimalPipe`](api/common/DecimalPipe) | none | +| `@angular/common` | `DeprecatedPercentPipe` | [`PercentPipe`](api/common/PercentPipe) | none | +| `@angular/forms` | [`NgFormSelectorWarning`](https://v8.angular.io/api/forms/NgFormSelectorWarning) | none | none +| `@angular/forms` | `ngForm` element selector | `ng-form` element selector | none diff --git a/aio/content/navigation.json b/aio/content/navigation.json index a57c609642..a8975f765d 100644 --- a/aio/content/navigation.json +++ b/aio/content/navigation.json @@ -703,6 +703,11 @@ "title": "Release Practices", "tooltip": "Angular versioning, release, support, and deprecation policies and practices." }, + { + "url": "guide/updating-to-version-9", + "title": "Updating to Version 9", + "tooltip": "Support for updating your application from version 8 to 9." + }, { "url": "guide/deprecations", "title": "Deprecations",