diff --git a/docs/src/main/asciidoc/tests-with-coverage.adoc b/docs/src/main/asciidoc/tests-with-coverage.adoc
index 5c6e46bf6f38b..0cda4d5b29bf3 100644
--- a/docs/src/main/asciidoc/tests-with-coverage.adoc
+++ b/docs/src/main/asciidoc/tests-with-coverage.adoc
@@ -179,6 +179,11 @@ There are some config options that affect this:
 
 include::{generated-dir}/config/quarkus-jacoco-jacoco-config.adoc[opts=optional, leveloffset=+1]
 
+[TIP]
+====
+When working with a multi-module project, then for code coverage to work properly, the upstream modules need to be properly xref:cdi-reference.adoc#bean_discovery[indexed].
+====
+
 == Coverage for tests not using @QuarkusTest
 
 The Quarkus automatic JaCoCo config will only work for tests that are annotated with `@QuarkusTest`. If you want to check