diff --git a/.changeset/slow-eggs-grab.md b/.changeset/slow-eggs-grab.md
new file mode 100644
index 0000000000..e4c537687f
--- /dev/null
+++ b/.changeset/slow-eggs-grab.md
@@ -0,0 +1,8 @@
+---
+'@backstage/repo-tools': minor
+---
+
+Api reference documentation improvements
+
+- breadcrumbs links semantics as code spans
+- new `@config` annotation to describe related config keys
diff --git a/.changeset/warm-parents-notice.md b/.changeset/warm-parents-notice.md
new file mode 100644
index 0000000000..9ea14e2068
--- /dev/null
+++ b/.changeset/warm-parents-notice.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-proxy-backend': patch
+---
+
+Add documentation to de api reference
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 2b130f50e0..bae62ccc7e 100644
--- a/packages/repo-tools/src/commands/api-reports/api-extractor.ts
+++ b/packages/repo-tools/src/commands/api-reports/api-extractor.ts
@@ -1037,7 +1037,7 @@ export async function buildDocs({
                 configuration,
                 text: ' > ',
               }),
-              new DocCodeSpanLink({ 
+              new DocCodeSpanLink({
                 configuration,
                 tagName: '@link',
                 linkText: hierarchyItem.displayName,