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

@@ -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
 
 
 # ================================================

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
 

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

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",