diff --git a/README.md b/README.md
index d6312d348..0a7cd0112 100644
--- a/README.md
+++ b/README.md
@@ -36,9 +36,11 @@ Powertools for AWS Lambda (Java) is available in Maven Central. You can use your
 </dependencies>
 ```
 
-And configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your project:
+Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your project. A different configuration is needed for projects on Java 8. 
 
-For Java 11+, use the following:
+<details>
+    <summary><b>Maven - Java 11 and newer</b></summary>
+    
 ```xml
 <build>
     <plugins>
@@ -78,8 +80,11 @@ For Java 11+, use the following:
     </plugins>
 </build>
 ```
+</details>
 
-For Java 8, use the following:
+<details>
+<summary><b>Maven - Java 8</b></summary>    
+    
 ```xml
 <build>
     <plugins>
@@ -119,11 +124,12 @@ For Java 8, use the following:
     </plugins>
 </build>
 ```
-#### gradle
+</details>
 
-For Java 11+:
+<details>
+<summary><b>Gradle - Java 11+</b></summary>
 
-    ```groovy
+```groovy
         plugins {
             id 'java'
             id 'io.freefair.aspectj.post-compile-weaving' version '8.1.0'
@@ -141,11 +147,13 @@ For Java 11+:
         
         sourceCompatibility = 11
         targetCompatibility = 11
-    ```
+```
+</details>
 
-For Java8:
+<details>
+<summary><b>Gradle - Java 8</b></summary>    
 
-    ```groovy
+```groovy
         plugins {
             id 'java'
             id 'io.freefair.aspectj.post-compile-weaving' version '6.6.3'
@@ -163,10 +171,10 @@ For Java8:
         
         sourceCompatibility = 1.8
         targetCompatibility = 1.8
-    ```
-
+```
+</details>
 
-## Example
+## Examples
 
 See the **[examples](examples)**  directory for example projects showcasing usage of different utilities.