X-Git-Url: http://juplo.de/gitweb/?p=hibernate4-maven-plugin;a=blobdiff_plain;f=src%2Fsite%2Fapt%2Findex.apt;h=76af67326d455ec6fb8d0e6b9a43176f258c3e0b;hp=f33e325d336e715ab4130d915427e9f616202ab3;hb=bd78c276663790bf7a3f121db85a0d62c64ce38c;hpb=1feb1053532279981a464cef954072cfefbe01a5

diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
index f33e325d..76af6732 100644
--- a/src/site/apt/index.apt
+++ b/src/site/apt/index.apt
@@ -1,29 +1,59 @@
-A simple Plugin for generating a Database-Schema from Hibernate 4 Mapping-Annotations.
+  ---
+  A simple Plugin for generating a Database-Schema from Hibernate 4 Mapping-Annotations.
+  ---
+  Kai Moritz
+  ---
 
   <<hibernate4-maven-plugin>> is a plugin for generating a database-schema
   from your Hibernate-4-Mappings and create or update your database
   accordingly.
+  Its main usage is to automatically create and populate a test-database
+  for unit-tests in cooperation with the
+  {{{http://mojo.codehaus.org/dbunit-maven-plugin/} dbunit-maven-plugin}}.
+
+  The plugin was designed with three main goals in mind:
+
+    * It should be easy to use.
+
+    * It should be maximal unlikely, to erase a producation-database by
+      accident.
+
+    * It should not slow down the development cycle.
+
+  To achieve the first goal, the convention-over-configuration paradigma
+  was applied and the plugin was stuffed with usefull logging-messages.
+  So, if in doubt, just turn on the {{{./debugging.html} debugging output}} with the <<<mvn -X ...>>>. 
+
+  To achieve the second goal, the precedence in which the configuration
+  locations are consulted was layouted in a way that makes it possible, to
+  prevent overwrites of the wrong database by accident.
+
+  Last but not least, in order to not slow down the development cycle, the
+  hibernate4-maven-plugin only executes the schema-export, if the mapping
+  or the dialect changes (or if you force it to do so).
 
-  The plugin was designed to be easy and safe to use, because it must not 
-  never, never happen, that you blow away your production database when
-  firering a maven-build of your webapp on your production-machine!
   For more information about the inspiration to write this tiny plugin,
   {{{/hibernate4-maven-plugin-a-simple-plugin-for-generating-a-database-schema-from-hibernate-4-mapping-annotations/} read our blog-article about the hibernate4-maven-plugin}}.
 
+Documentation
+
+ * See {{{./configuration.html} Configuration Examples}} for Usage-Explanations
+   and simple examples of how to use this plugin.
+
+ * See {{{./export-mojo.html}hibernate4:export}} and
+    {{{./plugin-info.html} Plugin Documentation}} for the full
+   autogenerated documentation. These are mostly configuration-options
+   of the Hibernate-Tools <<<SchemaExport>>> and <<<SchemaUpdate>>>, that do
+   the work in the background.
+
 Releases
 
  * {{{http://juplo.de/hibernate4-maven-plugin} current version}}
 
  * ${project.version} (this version)
 
- * {{{http://juplo.de/hibernate4-maven-plugin-1.0} 1.0}}
-
-Documentation and Examples
+ * {{{http://juplo.de/hibernate4-maven-plugin-1.0.2} 1.0.2}}
 
- * See {{{./examples.html} Examples}} for Usage-Explanations and simple
-   examples of how to use this plugin.
+ * {{{http://juplo.de/hibernate4-maven-plugin-1.0.1} 1.0.1}}
 
- * See {{{./plugin-info.html} Plugin Documentation}} for the full
-   autogenerated documentation. These are mostly configuration-options
-   of the Hibernate-Tools <<<SchemaExport>>> and <<<SchemaUpdate>>>, that do
-   the work in the background.
+ * {{{http://juplo.de/hibernate4-maven-plugin-1.0} 1.0}}