diff --git a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
index 9a1f6c4142..cf51ce8c85 100644
--- a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
+++ b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
@@ -4383,6 +4383,13 @@ knowledge of each other, you can also use `@AutoconfigureOrder`. That annotation
 same semantic as the regular `@Order` annotation but provides a dedicated order for
 auto-configuration classes.
 
+[NOTE]
+====
+Auto-configurations have to be loaded that way _only_. Make sure that they are defined in
+a specific package space and that they are never the target of component scan in
+particular.
+====
+
 
 
 [[boot-features-condition-annotations]]