docs: add link label & paragraph for correct display (#60708)

vladboisa · mmalerba · commit 0ee1a6e5936f · 2025-04-30T08:18:08.000-07:00
PR Close #60708
diff --git a/packages/core/src/linker/element_ref.ts b/packages/core/src/linker/element_ref.ts
@@ -54,7 +54,7 @@ export class ElementRef<T = any> {
    *   <p>
    *    Use this API as the last resort when direct access to DOM is needed. Use templating and
    *    data-binding provided by Angular instead. If used, it is recommended in combination with
-   *    {@link /best-practices/security#direct-use-of-the-dom-apis-and-explicit-sanitization-calls}
+   *    {@link /best-practices/security#direct-use-of-the-dom-apis-and-explicit-sanitization-calls DomSanitizer}
    *    for maxiumum security;
    *   </p>
    * </div>
diff --git a/packages/core/src/render/api.ts b/packages/core/src/render/api.ts
@@ -47,9 +47,11 @@ export abstract class RendererFactory2 {
  * rendering calls, or to render to something other than DOM.
  *
  * <div class="docs-alert docs-alert-important">
+ * <p>
  * Please be aware that usage of `Renderer2`, in context of accessing DOM elements, provides no
  * extra security which makes it equivalent to
- * {@link /best-practices/security#direct-use-of-the-dom-apis-and-explicit-sanitization-calls}.
+ * {@link /best-practices/security#direct-use-of-the-dom-apis-and-explicit-sanitization-calls Security vulnerabilities}.
+ * </p>
  * </div>
  *
  * Create your custom renderer using `RendererFactory2`.

Original file line number	Diff line number	Diff line change
`@@ -47,9 +47,11 @@ export abstract class RendererFactory2 {`
`47`	`47`	`* rendering calls, or to render to something other than DOM.`
`48`	`48`	`*`
`49`	`49`	`* <div class="docs-alert docs-alert-important">`
	`50`	`+ * <p>`
`50`	`51`	* Please be aware that usage of `Renderer2`, in context of accessing DOM elements, provides no
`51`	`52`	`* extra security which makes it equivalent to`
`52`		`- * {@link /best-practices/security#direct-use-of-the-dom-apis-and-explicit-sanitization-calls}.`
	`53`	`+ * {@link /best-practices/security#direct-use-of-the-dom-apis-and-explicit-sanitization-calls Security vulnerabilities}.`
	`54`	`+ * </p>`
`53`	`55`	`* </div>`
`54`	`56`	`*`
`55`	`57`	* Create your custom renderer using `RendererFactory2`.