From e313aa5f6c54c313dbdcc5abb02fe45b370f38e9 Mon Sep 17 00:00:00 2001
From: tudormarc <93496164+tudormarc@users.noreply.github.com>
Date: Fri, 27 May 2022 16:30:52 +0300
Subject: [PATCH] Document that Lombok must be configured before our annotation
 processor

See gh-31190
---
 .../annotation-processor.adoc                 | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/configuration-metadata/annotation-processor.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/configuration-metadata/annotation-processor.adoc
index fdfe8a9092..10a4f955cc 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/configuration-metadata/annotation-processor.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/configuration-metadata/annotation-processor.adoc
@@ -59,6 +59,29 @@ You could also let the AspectJ plugin run all the processing and disable annotat
 ----
 ====
 
+[NOTE]
+====
+If you are also using lombok in your project, you need to make sure that the `lombok` dependency is placed before the `spring-boot-configuration-processor` dependency.
+Otherwise, combining `lombok` annotations with `spring-boot-configuration-processor` annotations will not have the desired result.
+
+[source,xml,indent=0,subs="verbatim"]
+----
+    <dependency>
+        <groupId>org.projectlombok</groupId>
+        <artifactId>lombok</artifactId>
+        <scope>provided</scope>
+    </dependency>
+
+    ...............
+
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-configuration-processor</artifactId>
+        <optional>true</optional>
+    </dependency>
+----
+====
+
 
 
 [[appendix.configuration-metadata.annotation-processor.automatic-metadata-generation]]