Next try on Markdown

ws/Archetypes/mi-maven-archetype-jpa-hibernate/src/main/resources/archetype-resources/Readme.md

@@ -5,16 +5,14 @@ General:
 --------
 This project contains:
 
-src/main/resources/META-INF/persistence.xml
-:  Defining two persistence units both offering a JDBC database
+* `src/main/resources/META-INF/persistence.xml`<br/>
+   Defining two persistence units both offering a JDBC database
    connection to a Mysql 5 server. You may want to adjust both
-   database type and connection parameters.
-
-:  The first unit will re-create the database schema whereas using
+   database type and connection parameters.<br/>
+   The first unit will re-create the database schema whereas using
    the second will preserve your current database schema.
  
-Java classes
-: 
+* 
 |Class         |Package               |Description           |
 |--------------|----------------------|----------------------|
 |`Airline`     |`$(packageroot)/model`|JPA example entity    |
@@ -22,14 +20,15 @@ Java classes
 |`SearchByIcao`|`$(packageroot)`      |JPA typesafe criteria search demo |
 |`EntityTest`  |`$(testroot)`         |Persisting and re-reading an object by primary key value |
 
-src/main/resources/log4j2.xml
-:  Configuring the log4j subsystem.
+* `src/main/resources/log4j2.xml` Configuring the log4j subsystem.
 
-On executing i.e. »`mvn install`« Maven will generate metamodel
-classes like `Airline_.java` during the »`generate-sources`« phase.
-These classes are being required for
+On executing i.e. »`mvn install`« Maven will 
+[generate]
+(https://docs.jboss.org/hibernate/orm/current/topical/html_single/metamodelgen/MetamodelGenerator.html)
+metamodel classes like `Airline_.java` during the
+»`generate-sources`« phase. These classes are being required for
 [typesafe criteria based queries]
-(http://docs.jboss.org/hibernate/entitymanager/3.6/reference/en/html/querycriteria.html#querycriteria-typedquery).
+(http://docs.jboss.org/hibernate/entitymanager/3.6/reference/en/html/querycriteria.html#querycriteria-typedquery)
 as being outlined in class `$(packageroot)`/`SearchByIcao`.
 
 Eclipse IDE users: