diff --git a/docs/src/test-reporters-js.md b/docs/src/test-reporters-js.md
index ed4424f3e1..24e346d849 100644
--- a/docs/src/test-reporters-js.md
+++ b/docs/src/test-reporters-js.md
@@ -289,7 +289,9 @@ export default defineConfig({
 
 You can use the built in `github` reporter to get automatic failure annotations when running in GitHub actions.
 
-Note that all other reporters work on GitHub Actions as well, but do not provide annotations.
+Note that all other reporters work on GitHub Actions as well, but do not provide annotations. Also, it is not recommended to
+use this annotation type if running your tests with a matrix strategy as the stack trace failures will multiply and obscure the
+GitHub file view.
 
 ```js title="playwright.config.ts"
 import { defineConfig } from '@playwright/test';