fix(upgrade): deprecate the dynamic version of `ngUpgrade`

packages/upgrade/src/dynamic/upgrade_adapter.ts

@@ -96,7 +96,8 @@ let upgradeCount: number = 0;
  *
  * ```
  *
- * @stable
+ * @deprecated Deprecated since v5. Use `upgrade/static` instead, which also supports
+ * [Ahead-of-Time compilation](guide/aot-compiler).
  */
 export class UpgradeAdapter {
   private idPrefix: string = `NG2_UPGRADE_${upgradeCount++}_`;
@@ -634,7 +635,8 @@ class ParentInjectorPromise {
 /**
  * Use `UpgradeAdapterRef` to control a hybrid AngularJS / Angular application.
  *
- * @stable
+ * @deprecated Deprecated since v5. Use `upgrade/static` instead, which also supports
+ * [Ahead-of-Time compilation](guide/aot-compiler).
  */
 export class UpgradeAdapterRef {
   /* @internal */

tools/public_api_guard/upgrade/index.d.ts

@@ -1,4 +1,4 @@
-/** @stable */
+/** @deprecated */
 export declare class UpgradeAdapter {
     constructor(ng2AppModule: Type<any>, compilerOptions?: CompilerOptions);
     bootstrap(element: Element, modules?: any[], config?: angular.IAngularBootstrapConfig): UpgradeAdapterRef;
@@ -11,7 +11,7 @@ export declare class UpgradeAdapter {
     }): void;
 }
 
-/** @stable */
+/** @deprecated */
 export declare class UpgradeAdapterRef {
     ng1Injector: angular.IInjectorService;
     ng1RootScope: angular.IRootScopeService;