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 6c46cacc54..42710f3edd 100644
--- a/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
+++ b/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
@@ -529,6 +529,10 @@ the configuration of your application. For example:
 	}
 ----
 
+NOTE: The getters and setters are mandatory, since binding is via
+standard Java Beans property descriptors, just like in Spring
+MVC. Some people use Project Lombok to add them automatically.
+
 When the `@EnableConfigurationProperties` annotation is applied to your `@Configuration`,
 any beans annotated with `@ConfigurationProperties` will be automatically configured
 from the `Environment` properties. This style of configuration works particularly well