docs: improve core package API documentation with additional reference links

SkyZeroZx · kirjs · commit 477df38d173c · 2025-11-25T10:19:39.000-05:00
(cherry picked from commit 67d41e9)
diff --git a/packages/core/src/application/application_tokens.ts b/packages/core/src/application/application_tokens.ts
@@ -113,6 +113,8 @@ export const ANIMATION_MODULE_TYPE = new InjectionToken<'NoopAnimations' | 'Brow
  * Angular will apply when inserting inline styles. If not provided, Angular will look up its value
  * from the `ngCspNonce` attribute of the application root node.
  *
+ * @see [Content security policy](best-practices/security#content-security-policy)
+ *
  * @publicApi
  */
 export const CSP_NONCE = new InjectionToken<string | null>(
@@ -175,6 +177,8 @@ export const IMAGE_CONFIG_DEFAULTS: ImageConfig = {
  *
  * @see {@link NgOptimizedImage}
  * @see {@link ImageConfig}
+ * @see [Responsive images](guide/image-optimization#responsive-images)
+ * @see [Using placeholders](guide/image-optimization#using-placeholders)
  * @publicApi
  */
 export const IMAGE_CONFIG = new InjectionToken<ImageConfig>(
diff --git a/packages/core/src/linker/component_factory.ts b/packages/core/src/linker/component_factory.ts
@@ -21,6 +21,8 @@ import type {ViewRef} from './view_ref';
  * Provides access to the component instance and related objects,
  * and provides the means of destroying the instance.
  *
+ * @see [Programmatically rendering components](guide/components/programmatic-rendering)
+ *
  * @publicApi
  */
 export abstract class ComponentRef<C> {
diff --git a/packages/core/src/sanitization/sanitizer.ts b/packages/core/src/sanitization/sanitizer.ts
@@ -12,6 +12,8 @@ import {SecurityContext} from './security';
 /**
  * Sanitizer is used by the views to sanitize potentially dangerous values.
  *
+ * @see [Sanitization and security contexts](best-practices/security#sanitization-and-security-contexts)
+ *
  * @publicApi
  */
 export abstract class Sanitizer {

Original file line number	Diff line number	Diff line change
`@@ -21,6 +21,8 @@ import type {ViewRef} from './view_ref';`
`21`	`21`	`* Provides access to the component instance and related objects,`
`22`	`22`	`* and provides the means of destroying the instance.`
`23`	`23`	`*`
	`24`	`+ * @see [Programmatically rendering components](guide/components/programmatic-rendering)`
	`25`	`+ *`
`24`	`26`	`* @publicApi`
`25`	`27`	`*/`
`26`	`28`	`export abstract class ComponentRef<C> {`
Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,8 @@ import {SecurityContext} from './security';`
`12`	`12`	`/**`
`13`	`13`	`* Sanitizer is used by the views to sanitize potentially dangerous values.`
`14`	`14`	`*`
	`15`	`+ * @see [Sanitization and security contexts](best-practices/security#sanitization-and-security-contexts)`
	`16`	`+ *`
`15`	`17`	`* @publicApi`
`16`	`18`	`*/`
`17`	`19`	`export abstract class Sanitizer {`