diff --git a/.changeset/famous-clocks-visit.md b/.changeset/famous-clocks-visit.md
new file mode 100644
index 0000000000..66c2048872
--- /dev/null
+++ b/.changeset/famous-clocks-visit.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-permission-node': patch
+---
+
+Fix invalid cross-reference in API Reference docs
diff --git a/.changeset/tender-turkeys-begin.md b/.changeset/tender-turkeys-begin.md
new file mode 100644
index 0000000000..26e376cecf
--- /dev/null
+++ b/.changeset/tender-turkeys-begin.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-permission-react': patch
+---
+
+Improve API Reference documentation
diff --git a/packages/repo-tools/src/commands/api-reports/api-extractor.ts b/packages/repo-tools/src/commands/api-reports/api-extractor.ts
index 6a523af6a9..122f04cc7e 100644
--- a/packages/repo-tools/src/commands/api-reports/api-extractor.ts
+++ b/packages/repo-tools/src/commands/api-reports/api-extractor.ts
@@ -145,7 +145,7 @@ ApiReportGenerator.generateReviewFileContent =
           if (!localName) {
             // Sometimes the symbol name is suffixed with a number to disambiguate,
             // e.g. "Props_14" instead of "Props" if there are multiple Props interfaces
-            // so we tyry to strip that suffix and look up the symbol again.
+            // so we try to strip that suffix and look up the symbol again.
             const [, trimmedSymbolName] = symbolName.match(/(.*)_\d+/) || [];
             localName = (sourceFile as any).identifiers?.get(trimmedSymbolName);
           }
diff --git a/plugins/permission-node/src/types.ts b/plugins/permission-node/src/types.ts
index 36e30714f6..0a7e06ed91 100644
--- a/plugins/permission-node/src/types.ts
+++ b/plugins/permission-node/src/types.ts
@@ -23,7 +23,7 @@ import { NoInfer } from './integration/util';
 
 /**
  * A conditional rule that can be provided in an
- * {@link @backstage/permission-common#AuthorizeDecision} response to an authorization request.
+ * {@link @backstage/plugin-permission-common#AuthorizeDecision} response to an authorization request.
  *
  * @remarks
  *
diff --git a/plugins/permission-react/api-report.md b/plugins/permission-react/api-report.md
index 3c1961c92c..4c51d16b80 100644
--- a/plugins/permission-react/api-report.md
+++ b/plugins/permission-react/api-report.md
@@ -100,6 +100,4 @@ export function usePermission(
         resourceRef: string | undefined;
       },
 ): AsyncPermissionResult;
-
-// (No @packageDocumentation comment for this package)
 ```
diff --git a/plugins/permission-react/src/index.ts b/plugins/permission-react/src/index.ts
index 57352c5cdd..de6958b3e5 100644
--- a/plugins/permission-react/src/index.ts
+++ b/plugins/permission-react/src/index.ts
@@ -14,6 +14,11 @@
  * limitations under the License.
  */
 
+/**
+ * Components and hooks to help implement permissions in Backstage frontend plugins.
+ *
+ * @packageDocumentation
+ */
 export * from './components';
 export * from './hooks';
 export * from './apis';