diff --git a/.changeset/pink-sheep-dress.md b/.changeset/pink-sheep-dress.md
index 949604cde2..a4182efde2 100644
--- a/.changeset/pink-sheep-dress.md
+++ b/.changeset/pink-sheep-dress.md
@@ -2,4 +2,7 @@
 '@backstage/repo-tools': patch
 ---
 
-Fix issues with warnings not being reported due to bad filename path when reading report
+Fix issues with warnings in API reports not being checked or reported.
+
+Due to the recent version bump of API Extractor you may now see a lot of `ae-undocumented` warnings,
+these can be ignored using the `-o` option, for example, `backstage-repo-tools api-reports -o ae-undocumented,ae-wrong-input-file-type`.