chore(docs): add api documenter patch

Author: grega

patches/@microsoft+api-documenter+7.28.2.patch

@@ -0,0 +1,80 @@
+diff --git a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js
+index 716b861..853a6b1 100644
+--- a/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js
++++ b/node_modules/@microsoft/api-documenter/lib/documenters/MarkdownDocumenter.js
+@@ -893,12 +893,14 @@ class MarkdownDocumenter {
+     }
+     _writeBreadcrumb(output, apiItem) {
+         const configuration = this._tsdocConfiguration;
+-        output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({
+-            configuration,
+-            tagName: '@link',
+-            linkText: 'Home',
+-            urlDestination: this._getLinkFilenameForApiItem(this._apiModel)
+-        }));
++        // Don't print the first breadcrumb, because there's only one package, so we don't need the Home link.
++        // output.appendNodeInParagraph(new tsdoc_1.DocLinkTag({
++        //     configuration,
++        //     tagName: '@link',
++        //     linkText: 'Home',
++        //     urlDestination: this._getLinkFilenameForApiItem(this._apiModel)
++        // }));
++        let first = true;
+         for (const hierarchyItem of apiItem.getHierarchy()) {
+             switch (hierarchyItem.kind) {
+                 case api_extractor_model_1.ApiItemKind.Model:
+@@ -908,18 +910,24 @@ class MarkdownDocumenter {
+                     // this may change in the future.
+                     break;
+                 default:
+-                    output.appendNodesInParagraph([
+-                        new tsdoc_1.DocPlainText({
+-                            configuration,
+-                            text: ' > '
+-                        }),
++                    if (!first) {
++                        // Only print the breadcrumb separator if it's not the first item we're printing.
++                        output.appendNodeInParagraph(
++                            new tsdoc_1.DocPlainText({
++                                configuration,
++                                text: ' > '
++                            })
++                        );
++                    }
++                    first = false;
++                    output.appendNodeInParagraph(
+                         new tsdoc_1.DocLinkTag({
+                             configuration,
+                             tagName: '@link',
+                             linkText: hierarchyItem.displayName,
+                             urlDestination: this._getLinkFilenameForApiItem(hierarchyItem)
+                         })
+-                    ]);
++                    );
+             }
+         }
+     }
+@@ -992,11 +1000,8 @@ class MarkdownDocumenter {
+             // For overloaded methods, add a suffix such as "MyClass.myMethod_2".
+             let qualifiedName = Utilities_1.Utilities.getSafeFilenameForName(hierarchyItem.displayName);
+             if (api_extractor_model_1.ApiParameterListMixin.isBaseClassOf(hierarchyItem)) {
+-                if (hierarchyItem.overloadIndex > 1) {
+-                    // Subtract one for compatibility with earlier releases of API Documenter.
+-                    // (This will get revamped when we fix GitHub issue #1308)
+-                    qualifiedName += `_${hierarchyItem.overloadIndex - 1}`;
+-                }
++                // https://github.com/microsoft/rushstack/issues/1921
++                qualifiedName += `_${hierarchyItem.overloadIndex}`;
+             }
+             switch (hierarchyItem.kind) {
+                 case api_extractor_model_1.ApiItemKind.Model:
+@@ -1007,7 +1012,8 @@ class MarkdownDocumenter {
+                     baseName = Utilities_1.Utilities.getSafeFilenameForName(node_core_library_1.PackageName.getUnscopedName(hierarchyItem.displayName));
+                     break;
+                 default:
+-                    baseName += '.' + qualifiedName;
++                    // https://github.com/microsoft/rushstack/issues/1921
++                    baseName += '.' + qualifiedName + '_' + hierarchyItem.kind.toLowerCase();
+             }
+         }
+         return baseName + '.md';