more revision of the tools page

Author: gavinking

tools/index.html.haml

@@ -9,22 +9,30 @@ project: tools
   :asciidoc
     == Reverse engineering from a database
 
-    Hibernate Tools is a set of build plugins and a Java library that can be used to generate Hibernate/JPA entities starting
-    from your relational database structure. The default behavior of the code generator is highly customizable via
-    XML or by plugging in custom generation strategies. In addition, other artefacts such as DAO classes, HTML
-    documentation, or even UI components can be generated by using and/or adding additional generation templates.
-    The API can be used from custom Java classes but is also readily usable in Maven, Gradle and Ant. Other
-    possibilities such as JBang and Quarkus are in the works.
+    Hibernate Tools generates entity classes from a relational database schema.
+    The code generator is is written in Java, and can be called directly from Java code, but it's also integrated with
+    Maven, Gradle, and Ant.
 
     image::/tools/images/reveng.png[Reverse Engineering]
 
+.feature-block
+  :asciidoc
+    == Customizable code generation
+
+    The generated code is highly customizable:
+
+    - via XML-based configuration, or
+    - by plugging in custom generation strategies.
+
+    In addition to entities, artefacts such as DAO classes, HTML documentation, or even UI components may be generated
+    via the use of custom or built-in generation templates.
+
 .feature-block
   :asciidoc
     == Project configuration
 
-    For the purpose of a quick introduction, let's suppose that we have a database running, for example,
-    https://github.com/maxandersen/sakila-h2[H2 Sakila database], reachable at the following JDBC URL:
-    `jdbc:h2:tcp://localhost/./sakila`.
+    Let's suppose that we have a database running, for example, the
+    https://github.com/maxandersen/sakila-h2[H2 Sakila database].
 
     Let's also suppose that the following `hibernate.properties` file is available somewhere on the project class path:
 
@@ -79,7 +87,7 @@ project: tools
     </project>
     ----
 
-    Let's assume as well that the `src/main/resources` folder contains the `hibernate.properties` file shown earlier.
+    Let's also assume that the `src/main/resources` folder contains the `hibernate.properties` file shown earlier.
 
     Having this in place, simply issuing:
     [source]