basic linking for the doc
diff --git a/winegrower-documentation/pom.xml b/winegrower-documentation/pom.xml
index 9e57aee..288ea24 100644
--- a/winegrower-documentation/pom.xml
+++ b/winegrower-documentation/pom.xml
@@ -76,7 +76,7 @@
</goals>
<configuration>
<sourceDirectory>${project.basedir}/../winegrower-extension/winegrower-build/winegrower-maven-plugin/src/main/asciidoc</sourceDirectory>
- <outputDirectory>${project.build.directory}/documentation/maven</outputDirectory>
+ <outputDirectory>${project.build.directory}/documentation/extensions/maven</outputDirectory>
</configuration>
</execution>
<execution>
@@ -87,7 +87,7 @@
</goals>
<configuration>
<sourceDirectory>${project.basedir}/../winegrower-extension/winegrower-testing/winegrower-testing-junit5/src/main/asciidoc</sourceDirectory>
- <outputDirectory>${project.build.directory}/documentation/junit5</outputDirectory>
+ <outputDirectory>${project.build.directory}/documentation/extensions/junit5</outputDirectory>
</configuration>
</execution>
<execution>
@@ -98,7 +98,7 @@
</goals>
<configuration>
<sourceDirectory>${project.basedir}/../winegrower-extension/winegrower-cdi/src/main/asciidoc</sourceDirectory>
- <outputDirectory>${project.build.directory}/documentation/cdi</outputDirectory>
+ <outputDirectory>${project.build.directory}/documentation/extensions/cdi</outputDirectory>
</configuration>
</execution>
</executions>
diff --git a/winegrower-documentation/src/main/asciidoc/index.adoc b/winegrower-documentation/src/main/asciidoc/index.adoc
index a38ee0e..51162a7 100644
--- a/winegrower-documentation/src/main/asciidoc/index.adoc
+++ b/winegrower-documentation/src/main/asciidoc/index.adoc
@@ -1,4 +1,4 @@
= Apache Winegrower
-
-TBD
+* xref:core/index.adoc[Core] documentation
+* xref:extensions/index.adoc[Extension] documentation
diff --git a/winegrower-extension/src/main/asciidoc/index.adoc b/winegrower-extension/src/main/asciidoc/index.adoc
index 5e734b4..70e15e1 100644
--- a/winegrower-extension/src/main/asciidoc/index.adoc
+++ b/winegrower-extension/src/main/asciidoc/index.adoc
@@ -1,3 +1,5 @@
= Apache Winegrower Extensions
-TBD
+* xref:maven/index.adoc[Maven] documentation
+* xref:junit5/index.adoc[JUnit 5] documentation
+* xref:cdi/index.adoc[CDI] documentation
diff --git a/winegrower-extension/winegrower-testing/winegrower-testing-junit5/src/main/asciidoc/index.adoc b/winegrower-extension/winegrower-testing/winegrower-testing-junit5/src/main/asciidoc/index.adoc
index c060e18..fc051a1 100644
--- a/winegrower-extension/winegrower-testing/winegrower-testing-junit5/src/main/asciidoc/index.adoc
+++ b/winegrower-extension/winegrower-testing/winegrower-testing-junit5/src/main/asciidoc/index.adoc
@@ -1,3 +1,60 @@
= Apache Winegrower JUnit5
-TBD
+Apache Winegrower JUnit5 allows to rely on the modern JUnit 5 framework
+to test your application.
+
+== Dependency
+
+[source,xml]
+----
+<dependency>
+ <groupId>org.apache.winegrower</groupId>
+ <artifactId>winegrower-testing-junit5</artifactId>
+ <version>${winegrower.version}</version>
+</dependency>
+----
+
+== @Winegrower
+
+`@Winegrower` allows to start a `Ripener` per class. Each test class
+will use its own configuration based on the setup done thanks to
+`@Winegrower`.
+
+Example:
+
+[source,java]
+----
+@Winegrower
+class WinegrowerExtensionTest {
+ @Test
+ void doYourTest() {
+ // ...
+ }
+}
+
+----
+
+
+== @MonoWinegrower
+
+`@MonoWinegrower` is close to the previous flavor but it starts the `Ripener`
+a single time for the whole JVM lifecycle. It takes its configuration from a
+SPI on `Ripener.Configuration` class (registered thanks to `META-INF/services/org.apache.winegrower.Ripener$Configuration`).
+If you don't register a custom configuration, default one is used.
+
+IMPORTANT: this flavor boots your performances but all your test classes will
+share the same state so ensure to not leak anything which can impact another test.
+
+Example:
+
+[source,java]
+----
+@MonoWinegrower
+class WinegrowerExtensionTest {
+ @Test
+ void doYourTest() {
+ // ...
+ }
+}
+
+----
