From 243de58478a0aa6baa96385a68c86f46204a1c6d Mon Sep 17 00:00:00 2001
From: Jean Francois Denise <jdenise@jdenise-thinkpadp1gen3.rmtfr.csb>
Date: Mon, 8 Apr 2024 11:25:59 +0200
Subject: [PATCH] Add doc to cover Galleon options

---
 .../src/site/markdown/package-example.md.vm   | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/plugin/src/site/markdown/package-example.md.vm b/plugin/src/site/markdown/package-example.md.vm
index 8beaf28f..34f36765 100644
--- a/plugin/src/site/markdown/package-example.md.vm
+++ b/plugin/src/site/markdown/package-example.md.vm
@@ -49,6 +49,44 @@ The example below shows how to produce the latest released ${appServerName} serv
 </project>
 ```
 
+#[[##]]# Galleon options
+
+You have the ability to set some optional Galleon options when provisioning a WildFly Server.
+Galleon options are documented in the [Galleon documentation](http://docs.wildfly.org/galleon/#_built_in_and_product_specific_options) and 
+in the WildFly Galleon plugins [documentation](http://docs.wildfly.org/galleon-plugins/#_galleon_plugins).
+
+Galleon options usage example:
+
+```xml
+<project>
+    ...
+    <build>
+        ...
+        <plugins>
+            ...
+            <plugin>
+                <groupId>${project.groupId}</groupId>
+                <artifactId>${project.artifactId}</artifactId>
+                <version>${project.version}</version>
+                <configuration>
+                    ...
+                    <galleon-options>
+                        <!-- Provision a WildFly server that includes features and modules at the preview stability level
+                        <stability-level>preview</stability-level>
+                        <!-- Fork the Galleon provisioning in a separate process -->
+                        <jboss-fork-embedded>true</jboss-fork-embedded>
+                    </galleon-options>
+                </configuration>
+                ...
+            </plugin>
+            ...
+        </plugins>
+        ...
+    </build>
+...
+</project>
+```
+
 #[[##]]# Fine tune server configuration and package extra content
 
 The example below shows how to configure the plugin goal to execute CLI commands and copy extra content inside the installed server: