From f3f3acc6180d4bac2938685b5954b897a36c6272 Mon Sep 17 00:00:00 2001
From: Volodymyr Kliushnichenko <v.kliushnychenko@gmail.com>
Date: Sat, 19 Oct 2024 17:20:51 +0300
Subject: [PATCH 1/2] annotation processors order note

---
 docs/asciidoc/modules/avaje-inject.adoc              | 2 ++
 docs/asciidoc/modules/avaje-validator.adoc           | 1 +
 docs/asciidoc/mvc-api.adoc                           | 2 ++
 modules/jooby-cli/src/main/resources/cli/pom.xml.hbs | 2 ++
 4 files changed, 7 insertions(+)

diff --git a/docs/asciidoc/modules/avaje-inject.adoc b/docs/asciidoc/modules/avaje-inject.adoc
index 83348f8614..003976a5f9 100644
--- a/docs/asciidoc/modules/avaje-inject.adoc
+++ b/docs/asciidoc/modules/avaje-inject.adoc
@@ -18,6 +18,8 @@
       <version>...</version>
       <configuration>
         <annotationProcessorPaths>
+          <!-- if using lombok, it must be placed before the avaje-inject-generator -->
+          <!-- avaje-inject-generator must be placed before the jooby-apt -->
           <path>
             <groupId>io.avaje</groupId>
             <artifactId>avaje-inject-generator</artifactId>
diff --git a/docs/asciidoc/modules/avaje-validator.adoc b/docs/asciidoc/modules/avaje-validator.adoc
index 507be523d2..80248ce9b6 100644
--- a/docs/asciidoc/modules/avaje-validator.adoc
+++ b/docs/asciidoc/modules/avaje-validator.adoc
@@ -22,6 +22,7 @@ Bean validation via https://avaje.io/validator/[Avaje Validator].
       <version>...</version>
       <configuration>
         <annotationProcessorPaths>
+          <!-- if using lombok, it must be placed before the generator -->
           <path>
             <groupId>io.avaje</groupId>
             <artifactId>avaje-validator-generator</artifactId>
diff --git a/docs/asciidoc/mvc-api.adoc b/docs/asciidoc/mvc-api.adoc
index 155ccbdb6a..656c7177de 100644
--- a/docs/asciidoc/mvc-api.adoc
+++ b/docs/asciidoc/mvc-api.adoc
@@ -939,6 +939,8 @@ on them (mostly annotations processors).
     <artifactId>maven-compiler-plugin</artifactId>
     <configuration>
       <annotationProcessorPaths>
+        <!-- if using lombok, it must be placed before the jooby-apt -->
+        <!-- if using avaje-inject, it must be placed after lombok, but before the jooby-apt -->
         <path>
           <groupId>io.jooby</groupId>
           <artifactId>jooby-apt</artifactId>
diff --git a/modules/jooby-cli/src/main/resources/cli/pom.xml.hbs b/modules/jooby-cli/src/main/resources/cli/pom.xml.hbs
index 67d0dc31ec..c706664734 100644
--- a/modules/jooby-cli/src/main/resources/cli/pom.xml.hbs
+++ b/modules/jooby-cli/src/main/resources/cli/pom.xml.hbs
@@ -121,6 +121,8 @@
       {{#if apt}}
         <configuration>
           <annotationProcessorPaths>
+            <!-- if using lombok, it must be placed before the jooby-apt -->
+            <!-- if using avaje-inject, it must be placed after lombok, but before the jooby-apt -->
             <path>
               <groupId>io.jooby</groupId>
               <artifactId>jooby-apt</artifactId>

From 893bf5a5516cc6c987a28f7ceb68f33a47b5518e Mon Sep 17 00:00:00 2001
From: Volodymyr Kliushnichenko <v.kliushnychenko@gmail.com>
Date: Mon, 21 Oct 2024 20:50:01 +0300
Subject: [PATCH 2/2] add NOTE to adoc

---
 docs/asciidoc/modules/avaje-inject.adoc    | 5 +++++
 docs/asciidoc/modules/avaje-validator.adoc | 5 +++++
 docs/asciidoc/mvc-api.adoc                 | 5 +++++
 3 files changed, 15 insertions(+)

diff --git a/docs/asciidoc/modules/avaje-inject.adoc b/docs/asciidoc/modules/avaje-inject.adoc
index 003976a5f9..362dd27765 100644
--- a/docs/asciidoc/modules/avaje-inject.adoc
+++ b/docs/asciidoc/modules/avaje-inject.adoc
@@ -44,6 +44,11 @@ dependencies {
 }
 ----
 
+[NOTE]
+====
+Please note that the order of annotation processors is important. For example, if you're using `lombok` and `avaje-inject`, the correct order should be: `lombok` -> `avaje-inject` -> `jooby-apt`
+====
+
 3) Install Avaje Inject:
 
 .Installing Avaje Inject
diff --git a/docs/asciidoc/modules/avaje-validator.adoc b/docs/asciidoc/modules/avaje-validator.adoc
index 80248ce9b6..cf723661d5 100644
--- a/docs/asciidoc/modules/avaje-validator.adoc
+++ b/docs/asciidoc/modules/avaje-validator.adoc
@@ -47,6 +47,11 @@ dependencies {
 }
 ----
 
+[NOTE]
+====
+Please note that the order of annotation processors is important. For example, if you're using `lombok`, the correct order should be: `lombok` -> `avaje-validator`
+====
+
 3) Install
 
 .Java
diff --git a/docs/asciidoc/mvc-api.adoc b/docs/asciidoc/mvc-api.adoc
index 656c7177de..9fde7e0373 100644
--- a/docs/asciidoc/mvc-api.adoc
+++ b/docs/asciidoc/mvc-api.adoc
@@ -982,3 +982,8 @@ tasks.withType(JavaCompile) {
     ]
 }
 ----
+
+[NOTE]
+====
+Please note that the order of annotation processors is important. For example, if you're using `lombok` and `avaje-inject`, the correct order should be: `lombok` -> `avaje-inject` -> `jooby-apt`
+====