improved documentation
diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
index 940faa8..f820919 100644
--- a/src/site/apt/index.apt.vm
+++ b/src/site/apt/index.apt.vm
@@ -37,7 +37,8 @@
     generated by <<<maven-site-plugin>>> (see {{{https://issues.apache.org/jira/browse/MSITE-121}MSITE-121}}),
     which prevents simple content import to SCM.
 
-    The plugin has been tested with git scm too and by example can push content for github pages.
+    The plugin has been tested with git scm too and by example can
+    {{{./various-tips.html#Git_branch}push content for GitHub pages}}.
 
 
 * Implementation
@@ -81,8 +82,8 @@
 
     There are 2 known limitations:
     
-    * for svn, the plugin can create the initial SCM directory if it does not exist. But for git by example, if you use a branch,
-    the branch won't be created: you have to create it manually,
+    * for Subversion, the plugin can create the initial SCM directory if it does not exist. But for Git by example, if you use a branch,
+    the branch won't be created: you have to {{{./various-tips.html#Git_branch}create it manually}},
 
     * the plugin works well for multi-module websites publishing to a complete directory:
     you just need to publish <<<mvn site:stage>>> content. But if one module does not publish
@@ -101,7 +102,7 @@
 
     * fix inconsistent newlines generated by <<<maven-site-plugin>>> (caused by <<<site.vm>>> template and
       resources taken from skin jar without fixing newlines): {{{https://issues.apache.org/jira/browse/MSITE-121}MSITE-121}}
-      is fixed in (future) maven-site-plugin 3.4,
+      is fixed in maven-site-plugin 3.4,
 
     * improve {{{/wagon/wagon-providers/wagon-scm/}<<<wagon-scm>>>}} to put a whole directory content
       in one commit, and not with one commit per file.
diff --git a/src/site/apt/various-tips.apt.vm b/src/site/apt/various-tips.apt.vm
index e3a0618..6e13fc4 100644
--- a/src/site/apt/various-tips.apt.vm
+++ b/src/site/apt/various-tips.apt.vm
@@ -73,15 +73,15 @@
     </plugin>
 +----------------+
 
-  Initial creation of the branch has to be done manually, as a Git orphan branch:
+  <<Initial creation of the branch has to be done manually>>, as a Git orphan branch:
 
-  * <<<git checkout --orphan gh-pages>>> to create the branch locally,
+  1. <<<git checkout --orphan gh-pages>>> to create the branch locally,
 
-  * <<<rm .git/index ; git clean -fdx>>> to clean the branch content and let it empy,
+  2. <<<rm .git/index ; git clean -fdx>>> to clean the branch content and let it empy,
 
-  * copy an initial site content,
+  3. copy an initial site content,
 
-  * commit and push: <<<git add *>>>, <<<git commit -m "initial site content">>>, <<<git push>>>
+  4. commit and push: <<<git add *>>>, <<<git commit -m "initial site content">>>, <<<git push>>>
 
   []