updates to wording

symmetric/src/site/apt/features.apt

@@ -9,7 +9,7 @@ Features
 
   * <<Data Channels>> - Table synchronizations are grouped into independent channels
 
-  * <<Guaranteed Delivery>> - Synchronized data is guaranteed to arrive at the target destination.  If a synchronization fails, the same packet of data will be retried until it succeeds or manual intervention is taken.  All other data synchronization is halted for the failed channel only.  
+  * <<Guaranteed Delivery>> - Synchronized data is guaranteed to arrive at the target destination.  If a synchronization fails, the same batch of data will be retried until it succeeds or manual intervention is taken.  All other data synchronization is halted for the failed channel only.  
 
   * <<Transaction Aware>> - Data updates are recorded and replayed with the same atomicity
 

symmetric/src/site/apt/getting_started.apt

@@ -6,9 +6,17 @@
  ------ 
 
 Getting Started
-
 
+ To get a demo of SymmetricDS running, try the
+ {{{guide/user-guide.html#ch02-getting-started}Getting Started}} tutorial.
+
+ The User Guide describes the SymmetricDS library for data synchronization. It is
+ intended for users who want to be quickly familiarized with the software, configure it,
+ and use its features.
+
  {{{guide/user-guide.html}User Guide (Online)}}
 
  {{{guide/user-guide.pdf}User Guide (PDF)}}
+
+ Please be aware that the User Guide is not yet complete, but is useful already.
 

symmetric/src/site/apt/index.apt

@@ -13,51 +13,36 @@ Overview
  and withstand periods of network outage.
 
  By using database triggers, SymmetricDS guarantees that data changes are captured and atomicity is preserved.
- Support for database vendors is provided through a {{{terminology.html#DatabaseDialect}Database Dialect}},
+ Support for database vendors is provided through a Database Dialect layer,
  with implementations for MySQL and Oracle included.
 
- Each instance of SymmetricDS is a {{{terminology.html#Node}Node}} that contacts the registration
- server for its configuration.
- {{{terminology.html#NodeGroup}NodeGroups}} are groups of similar {{{terminology.html#Node}Nodes}}
- that are configured to synchronize their data.
- The data is categorized and placed in {{{terminology.html#Channel}Channels}} to provide control
- and eliminate contention of active changes.
- Synchronization can push data (trickle-back) or pull data (trickle-poll).
-
- SymmetricDS can be deployed in any of the following configurations:
-
-    * Web application archive (WAR) deployed to an application server such as Tomcat, Jetty, or JBoss
-
-    * Standalone service
-
-    * Embedded in an application
-
- SymmetricDS also allows for n-tier synchronization.  For example, a large retailer might deploy the following:
+ Synchronization can be configured to push data (trickle-back) or pull data (trickle-poll) at an interval.
+ SymmetricDS allows for n-tier synchronization, such as the following:
 
     * A farm of web server nodes fronting an enterprise-class general office database
 
     * A handful of regional servers for synchronizing from the general office to remote geographical areas
 
     * 1000(s) of store server nodes using a departmental class database to sync with a regional node
 
-    * 10(s) of POS register nodes using an embedded database to sync with a store server
+    * 10(s) of Point of Sale (POS) register nodes using an embedded database to sync with a store server
 
- SymmetricDS is licensed as open source software under the 
- {{{license.html}GNU Lesser General Public License}} (LGPL).
-
-Why SymmetricDS?
-
- SymmetricDS was built because the development team did not find a suitable open source solution that met the 
- core requirements for keeping store databases durably synchronized in 'real-time' with a general office database.
-
-History
+ Deployment options include the following:
 
- SymmetricDS was started as an open source project to document the experiences and solve the issues the development
- team encountered when integrating a store MySQL database with a corporate Oracle database for a major retailer.
- The software gained momentum and is now being used by that same retailer.  
-
+    * Web application archive (WAR) deployed to an application server such as Tomcat, Jetty, or JBoss
+
+    * Standalone service
+
+    * Embedded in an application
 
+ SymmetricDS is written in Java and licensed as open source software under the 
+ {{{license.html}GNU Lesser General Public License}} (LGPL).
 
+Background
 
-
-
+ While implementing a commercial Point of Sale (POS) system for a large retailer, the
+ development team concluded that the software available for trickling back
+ transactions to the general office did not meet the project needs. 
+ The team created a custom solution that met the requirements and made the project
+ successful. From this initial challenge came the knowledge and experience that
+ SymmetricDS benefits from today.

symmetric/src/site/site.xml

@@ -17,40 +17,39 @@
                 href="http://sourceforge.net/project/showfiles.php?group_id=206470" />
         </links>
 
-        <menu name="Project Info" href="maven-reports.html">
+        <menu name="About">
             <item name="Overview" href="/index.html" />
-            <item name="Features" href="/features.html" />
-            <item name="Terminology" href="/terminology.html" />
-            <item name="News" href="/news.html" />
-            <!--                    
-            <item name="Support" href="/support.html"/>
-            -->
-            <item name="Project License" href="/license.html" />
-            <item name="Project Team" href="/team-list.html" />
+            <item name="Features" href="/features.html" />
+            <item name="News" href="/news.html" />
+            <item name="Roadmap" href="/roadmap.html" />
+            <item name="License" href="/license.html" />
+            <item name="Team" href="/team-list.html" />
         </menu>
 
         <menu name="Documentation">
             <item name="Getting Started" href="getting_started.html" />
             <item name="JavaDoc" href="apidocs/index.html" />
+            <item name="Code Samples" href="/samples.html" />
         </menu>
 
-        <menu name="Community" href="maven-reports.html">
+        <menu name="Community">
             <item name="SourceForge Home" href="http://sourceforge.net/projects/symmetricds/" />
-            <item name="Mailing Lists" href="/mail-lists.html" />
-            <item name="Issue Tracking" href="/issue-tracking.html" />
-            <item name="Roadmap" href="/roadmap.html" />
+            <item name="Forums" href="http://sourceforge.net/forum/?group_id=206470" />
+            <item name="Bugs" href="http://sourceforge.net/tracker/?group_id=206470&amp;atid=997724" />
+            <item name="Feature Requests" href="http://sourceforge.net/tracker/?group_id=206470&amp;atid=997727" />
+            <item name="Support Requests" href="http://sourceforge.net/tracker/?group_id=206470&amp;atid=997725" />
+            <item name="Patches" href="http://sourceforge.net/tracker/?group_id=206470&amp;atid=997726" />
         </menu>
 
-        <menu name="Code" href="maven-reports.html">
+        <menu name="Code">
             <item name="Download"
                 href="http://sourceforge.net/project/showfiles.php?group_id=206470" />
-            <item name="Code Samples" href="/samples.html" />
-            <item name="Source Repository" href="/source-repository.html" />
+            <item name="Source Repository" href="http://sourceforge.net/svn/?group_id=206470" />
             <item name="Browsable Source Code" href="/jxr.html" />
-            <item name="TODO List" href="/taglist.html" />
+            <item name="Todo List" href="/taglist.html" />
         </menu>
 
-        <menu name="Project Reports" href="maven-reports.html">
+        <menu name="Reports">
             <item name="Test Report" href="surefire-report.html" />
             <item name="JDepends Report" href="jdepend-report.html" />
         </menu>