EXTSCRIPT-157: prepare and improve the site documentation for the 1.0.2 and 1.0.3 release announcments in the users list.

git-svn-id: https://svn.apache.org/repos/asf/myfaces/extensions/scripting/trunk@1303415 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index fb61f50..37b8244 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -51,8 +51,8 @@
                 </p>
                 <p>
                     As the video shows, you can make changes to almost all JSF artifacts on the fly, and at the next
-                    reload the
-                    changes are present. The result is a reduction in server restarts and better turn around times. The
+                    reload the changes are present.
+                    The result is a reduction in server restarts and better turn around times. The
                     same rapid prototyping approach which is normally present in scripting languages and scripting
                     language based frameworks.
 
@@ -83,7 +83,7 @@
         <section name="Short Overview over Ext-Scripting">
             <subsection name="Supported for Scripting Languages">
                 <p>
-                    Ext-Scripting currently only supports Groovy Java and Scala as dynamic languages.
+                    Ext-Scripting currently only supports Groovy Java and Scala (1.0.3+) as dynamic languages.
                     Additional languages will be provided in subsequent releases.
                 </p>
             </subsection>
@@ -99,7 +99,7 @@
                     Extensions scripting supports MyFaces only for now. Following versions are supported.
                 </p>
                 <ul>
-                    <li>1.2.8+ (note support will be dropped soon)</li>
+                    <li>1.2.8+ (note support will be dropped soon post 1.0.2)</li>
                     <li>2.0+</li>
                 </ul>
                 <p>
@@ -108,8 +108,8 @@
                 <p>
                     The JSF RI and Mojarra as time of writing are not supported due to missing framework hooks needed,
                     but Mojarra supports Groovy out of the box within the core engine. So for the time being only
-                    MyFaces can be used. Also Portlets for 1.0 are not supported, this limitation will be eliminated in
-                    future versions. Support for Mojarra will come post 1.0.
+                    MyFaces can be used. Also Portlets for 1.0.x are not supported, this limitation will be eliminated
+                    in future versions. Support for Mojarra maybe will come post 1.0.x.
                 </p>
             </subsection>
 
diff --git a/src/site/xdoc/installation.xml b/src/site/xdoc/installation.xml
index cc4ee10..f85b39e 100644
--- a/src/site/xdoc/installation.xml
+++ b/src/site/xdoc/installation.xml
@@ -47,14 +47,15 @@
             <subsection name="General Setup Information" >
              <p>
 
-                Ext-Scripting has a complete appendix list over all configuration and setup options
-                for a quick overview please visit the following links. If you need detailed
+                Ext-Scripting has a complete appendix list over all <a href="./configentries.html">configuration and
+                 setup</a> options as well as <a href="./exampleconfig.html">example configurations</a>.
+                For a quick overview please visit the following links. If you need detailed
                 setup information, then read further on.
              </p>
             </subsection>
             <subsection name="Links">
                 <p>
-                    <ul><a href="setup_steps.html">Appendix: Configuration Setup Steps</a> </ul>
+                    <ul><a href="setup_steps.html">Appendix: Configuration Setup Step Overview</a> </ul>
                     <ul><a href="exampleconfig.html">Appendix: Example Configurations</a> </ul>
                     <ul><a href="configentries.html">Appendix: List of Configuration Options</a> </ul>
                 </p>
@@ -73,7 +74,7 @@
 
         <section name="Download">
             <p>
-                With version 1.0 Ext-Scripting provides all necessary artifacts
+                With version 1.0.x Ext-Scripting provides all necessary artifacts
                 as download artifacts to get quickly started.
                 A kickstart project is provided which can be used as shell for your own
                 projects.
@@ -316,9 +317,9 @@
                 </ul>
 
                 <h4>Dynamic resource reloading</h4>
-                <p>additionally Ext-Scripting allows the reloading of dynamic webresources
-                like facelets templates images css files etc... For that additiona  an additional config param is
-                    available
+                <p>additionally Ext-Scripting allows the reloading of dynamic web resources
+                like facelets templates images css files etc...  An additional config param is
+                    available to enable this functionality.
                     </p>
                 <p>
                 <ul>
@@ -364,10 +365,10 @@
             <h4>Package Whitelisting</h4>
             <p>The last possible config entry is the ability to whitelist packages. If you have set this option
             then only whitelisted packages will be picked up for dynamic recompilation</p>
-            <p>With this option you can point your sourcedir to the normal compile source and mark
+            <p>With this option you can point your source dir to the normal compile source and mark
             special packages as dynamic (to isolate the dynamic part from the rest)</p>
 
-            For enabling this option add following entry to your web.xml:
+            To enalbe this option, add following entry to your web.xml:
              <source><![CDATA[
 <!-- ======================================================================================
     Optional: Whitelist of root packages where your sources should come from
diff --git a/src/site/xdoc/setup_steps.xml b/src/site/xdoc/setup_steps.xml
index d7fcfa2..3d54b67 100644
--- a/src/site/xdoc/setup_steps.xml
+++ b/src/site/xdoc/setup_steps.xml
@@ -43,10 +43,11 @@
                     <ul>
                         <li>Check if your installation environment is setup</li>
                         <li>Download the appropriate meta bundle and place it in WEB-INF/lib</li>
-                        <li>Download groovy-all.jar and place it in WEB-INF/lib</li>
-                        <li>Prepare your script paths</li>
-                        <li>Add your web.xml entries</li>
-                        <li>mvn clean install ...</li>
+                        <li>Download groovy-all.jar and or (scala-lang.jar and scala-compiler.jar) and place it in
+                            WEB-INF/lib</li>
+                        <li>Prepare your script paths (WEB-INF/java, WEB-INF/groovy, WEB-INF/scala)</li>
+                        <li>Add your <a href="./exampleconfig.html">web.xml</a> entries</li>
+                        <li>start the web application ...</li>
                     </ul>
                 </p>
                 <p>
@@ -54,8 +55,8 @@
                     <ul>
                         <li>Check if your installation environment is setup</li>
                         <li>Add your pom xml dependencies and the repository entry</li>
-                        <li>Prepare your script paths</li>
-                        <li>Add your web.xml entries</li>
+                        <li>Prepare your script paths (WEB-INF/java, WEB-INF/groovy, WEB-INF/scala)</li>
+                        <li>Add your <a href="./exampleconfig.html">web.xml</a> entries</li>
                         <li>mvn clean install ...</li>
                     </ul>
                 </p>
@@ -69,8 +70,8 @@
                         </li>
                         <li>Download groovy-all.jar and add it to your dependency and deployment settings</li>
                         <li>Prepare your script paths</li>
-                        <li>Add your web.xml entries</li>
-                        <li>mvn clean install ...</li>
+                        <li>Add your <a href="./exampleconfig.html">web.xml</a> entries</li>
+                        <li>start the web application ...</li>
                     </ul>
                 </p>
             </subsection>