2 files changed, 10 insertions, 0 deletions
diff --git a/scripts/apidocs/processing/jsdocs.ts b/scripts/apidocs/processing/jsdocs.ts
index 41c1b84a..55dea867 100644
--- a/scripts/apidocs/processing/jsdocs.ts
+++ b/scripts/apidocs/processing/jsdocs.ts
@@ -69,6 +69,10 @@ export function getSeeAlsos(jsdocs: JSDoc): string[] {
   return getTagsFromJSDoc(jsdocs, 'see', true);
 }
 
+export function getRemarks(jsdocs: JSDoc): string[] {
+  return getTagsFromJSDoc(jsdocs, 'remark');
+}
+
 function getOptionalTagFromJSDoc(
   jsdocs: JSDoc,
   type: string
diff --git a/scripts/apidocs/processing/signature.ts b/scripts/apidocs/processing/signature.ts
index c7ae872b..8f6cedcb 100644
--- a/scripts/apidocs/processing/signature.ts
+++ b/scripts/apidocs/processing/signature.ts
@@ -8,6 +8,7 @@ import {
   getDescription,
   getExamples,
   getJsDocs,
+  getRemarks,
   getSeeAlsos,
   getSince,
   getThrows,
@@ -39,6 +40,10 @@ export interface RawApiDocsSignature {
    */
   parameters: RawApiDocsParameter[];
   /**
+   * Additional comments of the signature that are supposed to stand out from the description.
+   */
+  remarks: string[];
+  /**
    * The return type of the signature.
    */
   returns: RawApiDocsType;
@@ -107,6 +112,7 @@ function processSignature(
       description: getDescription(jsdocs),
       since: getSince(jsdocs),
       parameters,
+      remarks: getRemarks(jsdocs),
       returns,
       throws: getThrows(jsdocs),
       signature: getSignatureText(signature),