diff --git a/aio/tools/transforms/templates/api/includes/annotations.html b/aio/tools/transforms/templates/api/includes/annotations.html
deleted file mode 100644
index ff0b6f6a193d..000000000000
--- a/aio/tools/transforms/templates/api/includes/annotations.html
+++ /dev/null
@@ -1,13 +0,0 @@
-{%- if doc.decorators.length %}
-
- Annotations
-
- {%- for decorator in doc.decorators %}
- @{$ decorator.name $}({$ decorator.arguments $})
-
- {%- if not decorator.notYetDocumented %}
- {$ decorator.description | marked $}
- {%- endif %}
- {%- endfor %}
-
-{%- endif -%}
diff --git a/packages/core/src/di/injectable.ts b/packages/core/src/di/injectable.ts
index d92500e94593..9496c0090e12 100644
--- a/packages/core/src/di/injectable.ts
+++ b/packages/core/src/di/injectable.ts
@@ -85,7 +85,6 @@ export interface Injectable {
/**
* Injectable decorator and metadata.
*
- * @Annotation
* @publicApi
*/
export const Injectable: InjectableDecorator = makeDecorator(
diff --git a/packages/core/src/di/metadata.ts b/packages/core/src/di/metadata.ts
index 856ecd308c59..254ffcf6fbbc 100644
--- a/packages/core/src/di/metadata.ts
+++ b/packages/core/src/di/metadata.ts
@@ -54,7 +54,6 @@ export interface Inject {
/**
* Inject decorator and metadata.
*
- * @Annotation
* @publicApi
*/
export const Inject: InjectDecorator = attachInjectFlag(
@@ -99,7 +98,7 @@ export interface Optional {}
/**
* Optional decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const Optional: OptionalDecorator =
@@ -147,7 +146,7 @@ export interface Self {}
/**
* Self decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const Self: SelfDecorator =
@@ -195,7 +194,7 @@ export interface SkipSelf {}
/**
* `SkipSelf` decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const SkipSelf: SkipSelfDecorator =
@@ -238,7 +237,7 @@ export interface Host {}
/**
* Host decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const Host: HostDecorator =
diff --git a/packages/core/src/di/metadata_attr.ts b/packages/core/src/di/metadata_attr.ts
index dc7646db032d..a94b44114295 100644
--- a/packages/core/src/di/metadata_attr.ts
+++ b/packages/core/src/di/metadata_attr.ts
@@ -56,7 +56,6 @@ export interface Attribute {
/**
* Attribute decorator and metadata.
*
- * @Annotation
* @publicApi
*/
export const Attribute: AttributeDecorator = makeParamDecorator(
diff --git a/packages/core/src/metadata/di.ts b/packages/core/src/metadata/di.ts
index 4c2e3bf88e1f..3e2d921312df 100644
--- a/packages/core/src/metadata/di.ts
+++ b/packages/core/src/metadata/di.ts
@@ -150,7 +150,6 @@ export interface ContentChildrenDecorator {
*
* {@example core/di/ts/contentChildren/content_children_example.ts region='Component'}
*
- * @Annotation
*/
(selector: ProviderToken|Function|string, opts?: {
descendants?: boolean,
@@ -165,7 +164,6 @@ export interface ContentChildrenDecorator {
* Type of the ContentChildren metadata.
*
*
- * @Annotation
* @publicApi
*/
export type ContentChildren = Query;
@@ -174,7 +172,6 @@ export type ContentChildren = Query;
* ContentChildren decorator and metadata.
*
*
- * @Annotation
* @publicApi
*/
export const ContentChildren: ContentChildrenDecorator = makePropDecorator(
@@ -242,7 +239,6 @@ export interface ContentChildDecorator {
*
* {@example core/di/ts/contentChild/content_child_example.ts region='Component'}
*
- * @Annotation
*/
(selector: ProviderToken|Function|string,
opts?: {descendants?: boolean, read?: any, static?: boolean}): any;
@@ -261,7 +257,7 @@ export type ContentChild = Query;
* ContentChild decorator and metadata.
*
*
- * @Annotation
+
*
* @publicApi
*/
@@ -328,7 +324,6 @@ export interface ViewChildrenDecorator {
*
* {@example core/di/ts/viewChildren/view_children_example.ts region='Component'}
*
- * @Annotation
*/
(selector: ProviderToken|Function|string,
opts?: {read?: any, emitDistinctChangesOnly?: boolean}): any;
@@ -346,7 +341,7 @@ export type ViewChildren = Query;
/**
* ViewChildren decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const ViewChildren: ViewChildrenDecorator = makePropDecorator(
@@ -410,7 +405,6 @@ export interface ViewChildDecorator {
*
* {@example core/di/ts/viewChild/view_child_howto.ts region='HowTo'}
*
- * @Annotation
*/
(selector: ProviderToken|Function|string, opts?: {read?: any, static?: boolean}): any;
new(selector: ProviderToken|Function|string,
@@ -427,7 +421,7 @@ export type ViewChild = Query;
/**
* ViewChild decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const ViewChild: ViewChildDecorator = makePropDecorator(
diff --git a/packages/core/src/metadata/directives.ts b/packages/core/src/metadata/directives.ts
index ec001285c482..52494e57b280 100644
--- a/packages/core/src/metadata/directives.ts
+++ b/packages/core/src/metadata/directives.ts
@@ -98,7 +98,6 @@ export interface DirectiveDecorator {
* accessible for components outside of the NgModule.
*
*
- * @Annotation
*/
(obj?: Directive): TypeDecorator;
@@ -111,7 +110,6 @@ export interface DirectiveDecorator {
/**
* Directive decorator and metadata.
*
- * @Annotation
* @publicApi
*/
export interface Directive {
@@ -291,7 +289,6 @@ export interface Directive {
* }
* ```
*
- * @Annotation
*/
queries?: {[key: string]: any};
@@ -511,7 +508,6 @@ export interface ComponentDecorator {
* To preserve sequences of whitespace characters, use the
* `ngPreserveWhitespaces` attribute.
*
- * @Annotation
*/
(obj: Component): TypeDecorator;
/**
@@ -663,7 +659,7 @@ export interface Component extends Directive {
/**
* Component decorator and metadata.
*
- * @Annotation
+
* @publicApi
*/
export const Component: ComponentDecorator = makeDecorator(
@@ -741,7 +737,7 @@ export interface Pipe {
}
/**
- * @Annotation
+
* @publicApi
*/
export const Pipe: PipeDecorator = makeDecorator(
@@ -820,7 +816,7 @@ export interface Input {
}
/**
- * @Annotation
+
* @publicApi
*/
export const Input: InputDecorator =
@@ -870,7 +866,7 @@ export interface Output {
}
/**
- * @Annotation
+
* @publicApi
*/
export const Output: OutputDecorator = makePropDecorator('Output', (alias?: string) => ({alias}));
@@ -929,7 +925,7 @@ export interface HostBinding {
}
/**
- * @Annotation
+
* @publicApi
*/
export const HostBinding: HostBindingDecorator =
@@ -1033,7 +1029,7 @@ export interface HostListener {
* The global target names that can be used to prefix an event name are
* `document:`, `window:` and `body:`.
*
- * @Annotation
+
* @publicApi
*/
export const HostListener: HostListenerDecorator =
diff --git a/packages/core/src/metadata/ng_module.ts b/packages/core/src/metadata/ng_module.ts
index 605ee7213df7..72006671a0e6 100644
--- a/packages/core/src/metadata/ng_module.ts
+++ b/packages/core/src/metadata/ng_module.ts
@@ -203,7 +203,6 @@ export interface NgModule {
}
/**
- * @Annotation
*/
export const NgModule: NgModuleDecorator = makeDecorator(
'NgModule', (ngModule: NgModule) => ngModule, undefined, undefined,