improve documentation site
diff --git a/maven-release-api/src/site/site.xml b/maven-release-api/src/site/site.xml
new file mode 100644
index 0000000..220ecbb
--- /dev/null
+++ b/maven-release-api/src/site/site.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+<project xmlns="http://maven.apache.org/DECORATION/1.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd">
+  <body>
+    <menu name="Overview">
+      <item name="Introduction" href="index.html"/>
+      <item name="JavaDocs" href="apidocs/index.html"/>
+      <item name="Source Xref" href="xref/index.html"/>
+      <!--item name="FAQ" href="faq.html"/-->
+    </menu>
+
+    <menu ref="parent" inherit="top" />
+  </body>
+</project>
\ No newline at end of file
diff --git a/maven-release-manager/src/main/components-fragment.xml b/maven-release-manager/src/main/components-fragment.xml
index 6f156e9..d6a0f60 100644
--- a/maven-release-manager/src/main/components-fragment.xml
+++ b/maven-release-manager/src/main/components-fragment.xml
@@ -20,6 +20,7 @@
 
 <component-set>
   <components>
+<!-- START SNIPPET: default-strategy -->
     <component>
       <role>org.apache.maven.shared.release.strategy.Strategy</role>
       <role-hint>default</role-hint>
@@ -76,6 +77,7 @@
         </updateVersionsPhases>
       </configuration>
     </component>
+<!-- END SNIPPET: default-strategy -->
     <component>
       <role>org.apache.maven.shared.release.phase.ReleasePhase</role>
       <role-hint>map-release-versions</role-hint>
diff --git a/maven-release-manager/src/site/apt/index.apt.vm b/maven-release-manager/src/site/apt/index.apt.vm
new file mode 100644
index 0000000..2f8fb14
--- /dev/null
+++ b/maven-release-manager/src/site/apt/index.apt.vm
@@ -0,0 +1,31 @@
+ ------
+ Maven Release Manager
+ ------
+ Hervé Boutemy
+ ------
+ 2019-11-03
+ ------
+
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements.  See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership.  The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License.  You may obtain a copy of the License at
+~~
+~~   http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied.  See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+Maven Release Manager
+
+ Maven Release Manager implements the release management engine with its default release strategy:
+ 
+%{snippet|id=default-strategy|file=${project.build.sourceDirectory}/../components-fragment.xml}
+ 
\ No newline at end of file
diff --git a/maven-release-policies/maven-release-oddeven-policy/src/site/site.xml b/maven-release-policies/maven-release-oddeven-policy/src/site/site.xml
new file mode 100644
index 0000000..220ecbb
--- /dev/null
+++ b/maven-release-policies/maven-release-oddeven-policy/src/site/site.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+<project xmlns="http://maven.apache.org/DECORATION/1.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd">
+  <body>
+    <menu name="Overview">
+      <item name="Introduction" href="index.html"/>
+      <item name="JavaDocs" href="apidocs/index.html"/>
+      <item name="Source Xref" href="xref/index.html"/>
+      <!--item name="FAQ" href="faq.html"/-->
+    </menu>
+
+    <menu ref="parent" inherit="top" />
+  </body>
+</project>
\ No newline at end of file
diff --git a/maven-release-policies/maven-release-semver-policy/src/site/site.xml b/maven-release-policies/maven-release-semver-policy/src/site/site.xml
new file mode 100644
index 0000000..220ecbb
--- /dev/null
+++ b/maven-release-policies/maven-release-semver-policy/src/site/site.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+<project xmlns="http://maven.apache.org/DECORATION/1.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd">
+  <body>
+    <menu name="Overview">
+      <item name="Introduction" href="index.html"/>
+      <item name="JavaDocs" href="apidocs/index.html"/>
+      <item name="Source Xref" href="xref/index.html"/>
+      <!--item name="FAQ" href="faq.html"/-->
+    </menu>
+
+    <menu ref="parent" inherit="top" />
+  </body>
+</project>
\ No newline at end of file
diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
index 4e3c20a..feeb33c 100644
--- a/src/site/apt/index.apt
+++ b/src/site/apt/index.apt
@@ -32,9 +32,15 @@
 *----------------------------------------------------------+----------------+
 || Module                                                  || Description   ||
 *----------------------------------------------------------+----------------+
+| {{{./maven-release-api/}maven-release-api}}              | APIs to implement to extend maven-release-plugin,
+*----------------------------------------------------------+----------------+
 | {{{./maven-release-manager/}maven-release-manager}}      | core classes,
 *----------------------------------------------------------+----------------+
-| {{{/plugins/maven-release-plugin/}maven-release-plugin}} | release plugin to use from Maven.
+| {{{./maven-release-plugin/}maven-release-plugin}}        | release plugin to use from Maven,
+*----------------------------------------------------------+----------------+
+| {{{./maven-release-policies/maven-release-oddeven-policy/}maven-release-oddeven-policy}} | a version policy that proposes even version numbers only for releases and odd numbers for development,
+*----------------------------------------------------------+----------------+
+| {{{./maven-release-policies/maven-release-semver-policy/}maven-release-semver-policy}} | a version policy that enforce SemVer format and upgrades minor element for next development version.
 *----------------------------------------------------------+----------------+
 
 Notes for Developers
diff --git a/src/site/site.xml b/src/site/site.xml
index 80398de..027bb6a 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -22,13 +22,7 @@
 <project xmlns="http://maven.apache.org/DECORATION/1.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd">
-  
-  <skin>
-    <groupId>org.apache.maven.skins</groupId>
-    <artifactId>maven-fluido-skin</artifactId>
-    <version>1.7</version>
-  </skin>
-  
+
   <body>
     <menu name="Overview">
       <item name="Introduction" href="index.html"/>