adding openapi maven plugin and fixing api of opentracing
diff --git a/geronimo-microprofile-site/src/main/jbake/content/openapi.adoc b/geronimo-microprofile-site/src/main/jbake/content/openapi.adoc
index 6b407e7..7d71dca 100644
--- a/geronimo-microprofile-site/src/main/jbake/content/openapi.adoc
+++ b/geronimo-microprofile-site/src/main/jbake/content/openapi.adoc
@@ -29,3 +29,37 @@
<version>1.0.0</version>
</dependency>
----
+
+=== Maven Plugin
+
+The maven plugin allows you to generate an ̀`openapi.json` at build time:
+
+[source,xml]
+----
+<plugin>
+ <groupId>org.apache.geronimo</groupId>
+ <artifactId>geronimo-openapi-maven-plugin</artifactId>
+ <version>${openapi.version}</version>
+ <executions>
+ <execution>
+ <id>generate-openapi.json</id>
+ <goals>
+ <goal>openapi.json</goal>
+ </goals>
+ <configuration>
+ <application>com.test.MyApp</application>
+ <endpointClasses>
+ <endpointClass>com.test.SomeEndpoint</endpointClass>
+ <endpointClass>com.test.SomeOtherEndpoint</endpointClass>
+ </endpointClasses>
+ </configuration>
+ </execution>
+ </executions>
+</plugin>
+----
+
+Since it uses static analysis (no scanning yet) then you need to fill the application class
+if you have any custom configuration on it and all endpoints you want to document.
+
+Then for your runtime you can set the following configuration entries to avoid the runtime to scan again `mp.openapi.scan.disable=true`.
+
diff --git a/geronimo-microprofile-site/src/main/jbake/content/opentracing.adoc b/geronimo-microprofile-site/src/main/jbake/content/opentracing.adoc
index 9e0bd1c..c9c4801 100644
--- a/geronimo-microprofile-site/src/main/jbake/content/opentracing.adoc
+++ b/geronimo-microprofile-site/src/main/jbake/content/opentracing.adoc
@@ -42,6 +42,11 @@
</exclusion>
</exclusions>
</dependency>
+<dependency>
+ <groupId>io.opentracing</groupId>
+ <artifactId>opentracing-api</artifactId>
+ <version>0.31.0</version>
+</dependency>
----
=== Implementation
@@ -49,13 +54,8 @@
[source,xml]
----
<dependency>
- <groupId>io.opentracing</groupId>
- <artifactId>opentracing-api</artifactId>
- <version>0.31.0</version>
-</dependency>
-<dependency>
<groupId>org.apache.geronimo</groupId>
<artifactId>geronimo-opentracing</artifactId>
- <version>1.0.1-SNAPSHOT</version>
+ <version>1.0.1</version>
</dependency>
----
