Index: /FCKeditor.Java/branches/2.4/src/site/apt/index.apt
===================================================================
--- /FCKeditor.Java/branches/2.4/src/site/apt/index.apt	(revision 1979)
+++ /FCKeditor.Java/branches/2.4/src/site/apt/index.apt	(revision 1980)
@@ -25,18 +25,26 @@
 
   The FCKeditor.Java Integration makes the deployment of the FCKeditor in your
-  Java environment a piece of cake.\
+  Java environment a piece of cake.
+
   A rich documentation, a well-designed Java library, and an out of the box demo 
   webapp will show you how to get started quickly and deploy the FCKeditor within
-  minutes without juggling with cryptic JSP scriptlets or any JavaScript API.\
+  minutes without juggling with cryptic JSP scriptlets or any JavaScript API.
   Although it's targeted to be used as a tag library within JSPs but it's a snap
   within a template engine like {{{http://velocity.apache.org}Velocity}} or 
   {{{http://freemarker.org}Freemaker}} too.
 
-  Start with the {{{demo.html}demo}} first and proceed to the {{{installation.html}installation guide}}
-  if you are ready to deploy the FCKeditor in your webapp.
+* Documentation Guideline
+  
+  This documentation is straight forward to use!\
+  Start with {{{whatsnews.html}What's New}} to see what has changed since 2.3 and
+  there is a lot! Go over and checkout the {{{demo.html}Demo}} and if you are 
+  ready to deploy the FCKeditor in your webapp follow the 
+  {{{installation.html}Installation Guide}} and the {{{overview.html}Integration Overview}}.
+  
 
 Call To Action
 
-  Help us to improve the FCKeditor.Java Integration!\
+  Help us to improve the FCKeditor.Java Integration!
+
   If you think this documentation, the Java library or anything else is lacking 
   something, contains errors, or can be improved do <not> hesitate to open a 
Index: /FCKeditor.Java/branches/2.4/src/site/apt/properties.apt
===================================================================
--- /FCKeditor.Java/branches/2.4/src/site/apt/properties.apt	(revision 1979)
+++ /FCKeditor.Java/branches/2.4/src/site/apt/properties.apt	(revision 1980)
@@ -24,8 +24,9 @@
 Configuration setting
 
-  All properties are optional. In the meaning of 'Convention over Configuration' 
-  only the properties, of which the default isn't requested, have to be set.
+  All properties are optional, i.e. you do have to set any of them not even a 
+  single one. Define only those you intend to override for the <entire> web 
+  application.
 
-  There are two ways to overwrite the default properties: 
+  There are two ways to override the default properties: 
 
   * By creating a <<<fckeditor.properties>>> file in the classpath (usually 
@@ -61,6 +62,6 @@
   []
 
-  As you see, in both ways the name of the properties are equal. The tables below 
-  lists all the configurable properties for the integration pack.
+  As you can see, setting a property is equal in both ways. The tables below 
+  list all configurable properties for the integration pack.
 
 Configuration properties
