docs: asyncapi-generator

Author: ivangsa

plugins/asyncapi-generator/README.md

@@ -6,7 +6,11 @@
 
 ![AsyncAPI and Spring Cloud Streams 3](../../docs/ZenWave360-AsyncAPI-SpringCloudStreams.excalidraw.svg)
 
-The ZenWave AsyncAPI Generator solves a long-standing issue in event-driven Java applications: keeping message models and channel contracts fully aligned with their AsyncAPI specification. It provides build-time read-only code generation from AsyncAPI files sourced from their canonical locations: local files, classpath resources, or authenticated remote URLs.
+The ZenWave AsyncAPI Generator solves a long-standing issue in event-driven Java applications: 
+
+👉 keeping message models and channel contracts fully aligned with their AsyncAPI specification. 
+
+It provides build-time read-only code generation from AsyncAPI files sourced from their canonical locations: local files, classpath resources, or authenticated remote URLs.
 
 This approach eliminates API drift by enforcing the AsyncAPI file as the single source of truth for message schemas, channel definitions, and producer or consumer interfaces.
 
@@ -212,12 +216,7 @@ tasks.register<dev.jbang.gradle.tasks.JBangTask>("generateAsyncApiProvider") {
         "--deps=" +
             "org.slf4j:slf4j-simple:1.7.36," +
             "io.zenwave360.sdk.plugins:asyncapi-generator:RELEASE," +
-            "org.apache.avro:avro-compiler:1.11.1",
-        "--java-options \"--add-exports=jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED\"",
-        "--java-options \"--add-exports=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED\"",
-        "--java-options \"--add-exports=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED\"",
-        "--java-options \"--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED\"",
-        "--java-options \"--add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED\""
+            "org.apache.avro:avro-compiler:1.11.1"
     ))
     args.set(listOf(
         "-p", "AsyncAPIGenerator",

plugins/avro-schema-compiler/README.md

@@ -13,6 +13,17 @@ It supports Avro versions from 1.8.0 up to 1.12.0.
 - Automatically **sorts schemas** to resolve dependencies for Avro versions prior to 1.12.0.
 - Ensures generated code is consistent and ready for integration in Java projects.
 
+<!-- TOC -->
+* [Avro Schema Generator](#avro-schema-generator)
+    * [Why use this Avro Compiler Plugin?](#why-use-this-avro-compiler-plugin)
+  * [Usage](#usage)
+    * [Using the ZenWave CLI](#using-the-zenwave-cli)
+    * [Using the ZenWave Maven Plugin](#using-the-zenwave-maven-plugin)
+    * [Gradle Usage](#gradle-usage)
+  * [Options](#options)
+  * [Getting Help](#getting-help)
+<!-- TOC -->
+
 ## Usage
 
 ### Using the ZenWave CLI
@@ -29,6 +40,16 @@ jbang zw -p io.zenwave360.sdk.plugins.AvroSchemaGeneratorPlugin \
     targetFolder=target/generated-sources/avro
 ```
 
+This will generate the following Java classes:
+
+```shell
+$ find target/ -type f
+target/generated-sources/avro/src/main/java/io/zenwave360/example/core/outbound/events/dtos/Address.java
+target/generated-sources/avro/src/main/java/io/zenwave360/example/core/outbound/events/dtos/CustomerEvent.java
+target/generated-sources/avro/src/main/java/io/zenwave360/example/core/outbound/events/dtos/PaymentMethod.java
+target/generated-sources/avro/src/main/java/io/zenwave360/example/core/outbound/events/dtos/PaymentMethodType.java
+```
+
 Generating from local folders and imports:
 
 ```shell
@@ -103,7 +124,7 @@ jbang zw -p io.zenwave360.sdk.plugins.AvroSchemaGeneratorPlugin \
 
 NOTE: you need to exclude jackson-core and jackson-databind from avro-compiler dependency to avoid conflicts with ZenWaveSDK requirements which expect newer versions.
 
-## Gradle Usage
+### Gradle Usage
 
 ```kotlin
 plugins {