docs(docs-infra): prevent from showing duplicate usage blocks in functions API docs

fixes angular#66398

Author: JeanMeche

adev/shared-docs/pipeline/api-gen/rendering/templates/class-method-info.tsx

@@ -12,15 +12,18 @@ import {
   ParameterEntryRenderable,
 } from '../entities/renderables.mjs';
 import {PARAM_KEYWORD_CLASS_NAME, REFERENCE_MEMBER_CARD_ITEM} from '../styling/css-classes.mjs';
+import {CodeSymbol} from './code-symbols';
 import {DeprecatedLabel} from './deprecated-label';
 import {Parameter} from './parameter';
 import {RawHtml} from './raw-html';
-import {CodeSymbol} from './code-symbols';
 
 /**
  * Component to render the method-specific parts of a class's API reference.
  */
-export function ClassMethodInfo(props: {entry: FunctionSignatureMetadataRenderable}) {
+export function ClassMethodInfo(props: {
+  entry: FunctionSignatureMetadataRenderable;
+  hideUsageNotes?: boolean;
+}) {
   const entry = props.entry;
 
   return (
@@ -43,7 +46,7 @@ export function ClassMethodInfo(props: {entry: FunctionSignatureMetadataRenderab
         <span className={PARAM_KEYWORD_CLASS_NAME}>@returns</span>
         <CodeSymbol code={entry.returnType} />
       </div>
-      {entry.htmlUsageNotes ? (
+      {entry.htmlUsageNotes && !props.hideUsageNotes ? (
         <div className={'docs-usage-notes'}>
           <span className={'docs-usage-notes-heading'}>Usage notes</span>
           <RawHtml value={entry.htmlUsageNotes} />

adev/shared-docs/pipeline/api-gen/rendering/templates/function-reference.tsx

@@ -22,23 +22,22 @@ import {printInitializerFunctionSignatureLine} from '../transforms/code-transfor
 import {getFunctionMetadataRenderable} from '../transforms/function-transforms.mjs';
 import {ClassMethodInfo} from './class-method-info';
 import {CodeSymbol} from './code-symbols';
+import {DeprecationWarning} from './deprecation-warning';
 import {HeaderApi} from './header-api';
 import {HighlightTypeScript} from './highlight-ts';
 import {SectionApi} from './section-api';
 import {SectionDescription} from './section-description';
 import {SectionUsageNotes} from './section-usage-notes';
-import {DeprecationWarning} from './deprecation-warning';
 
 export const signatureCard = (
   name: string,
   signature: FunctionSignatureMetadataRenderable,
-  opts: {id: string},
-  printSignaturesAsHeader: boolean,
+  opts: {id: string; printSignaturesAsHeader: boolean; hideUsageNotes?: boolean},
 ) => {
   return (
     <div id={opts.id} class={REFERENCE_MEMBER_CARD}>
       <header class={REFERENCE_MEMBER_CARD_HEADER}>
-        {printSignaturesAsHeader ? (
+        {opts.printSignaturesAsHeader ? (
           <HighlightTypeScript
             code={printInitializerFunctionSignatureLine(
               name,
@@ -57,7 +56,7 @@ export const signatureCard = (
         )}
       </header>
       <div class={REFERENCE_MEMBER_CARD_BODY}>
-        <ClassMethodInfo entry={signature} />
+        <ClassMethodInfo entry={signature} hideUsageNotes={opts.hideUsageNotes} />
       </div>
     </div>
   );
@@ -75,14 +74,11 @@ export function FunctionReference(entry: FunctionEntryRenderable) {
       <SectionApi entry={entry} />
       <div className={REFERENCE_MEMBERS}>
         {entry.signatures.map((s, i) =>
-          signatureCard(
-            s.name,
-            getFunctionMetadataRenderable(s, entry.moduleName, entry.repo),
-            {
-              id: `${s.name}_${i}`,
-            },
+          signatureCard(s.name, getFunctionMetadataRenderable(s, entry.moduleName, entry.repo), {
+            id: `${s.name}_${i}`,
             printSignaturesAsHeader,
-          ),
+            hideUsageNotes: true,
+          }),
         )}
       </div>
 

adev/shared-docs/pipeline/api-gen/rendering/templates/initializer-api-function.tsx

@@ -40,14 +40,10 @@ export function InitializerApiFunction(entry: InitializerApiFunctionRenderable)
 
       <div class={REFERENCE_MEMBERS}>
         {entry.callFunction.signatures.map((s, i) =>
-          signatureCard(
-            s.name,
-            getFunctionMetadataRenderable(s, entry.moduleName, entry.repo),
-            {
-              id: `${s.name}_${i}`,
-            },
+          signatureCard(s.name, getFunctionMetadataRenderable(s, entry.moduleName, entry.repo), {
+            id: `${s.name}_${i}`,
             printSignaturesAsHeader,
-          ),
+          }),
         )}
 
         {entry.subFunctions.reduce(
@@ -59,8 +55,8 @@ export function InitializerApiFunction(entry: InitializerApiFunctionRenderable)
                 getFunctionMetadataRenderable(s, entry.moduleName, entry.repo),
                 {
                   id: `${entry.name}_${s.name}_${i}`,
+                  printSignaturesAsHeader,
                 },
-                printSignaturesAsHeader,
               ),
             ),
           ],