anchor.diff:      </dependency>
   </dependencies>
   --
  -
  -You need the following extensions:
  -
  -* JPA
  -* Agroal (the database connection pool)
  -* your JDBC driver extension (`jdbc-postgresql-deployment`, `jdbc-h2-deployment`, `jdbc-mariadb-deployment`, ...)
  -* and generic {project-name} extensions: CDI (arc)
   
   Finally add the relevant configuration properties in `{config-file}`.
   
  
positive.code: Make up your mind on which approach you want to use
  --
  
  == Design questions
  
  * Is it appropriate to prioritize `persistence.xml` when it is present and ignore otherwise (i.e. disable automatic PU generation when `persistence.xml` is there
  * Is it appropriate to select `JTA` as the transaction type strategy
  * Is is appropriate to detect the dialect from the driver
  * Which properties are the most useful for Hibernate ORM?
  * Do we have a pass through of properties under something like `shamrock.hibernate`
  * which prefix do we want? `shamrock.hibernate`, `hibernate`, `jpa` etc
  ** what about `javax.persistence properties`?
  ** I'm leaning on supporting but not advertizing classical JPA and Hibernate ORM properties (no prefix).
  
  
  
  == How to run tests from the IDE
  
  
negative.code: :config-file: microprofile-config.properties
  :toc:
  
  == Using Hibernate ORM and JPA to persist your data
  
  Hibernate ORM is the de facto JPA implementation and offers you the full breath of a Object Relational Mapper.
  It works beautifully in {project-name}.
  
  === Setting up and configuring Hibernate ORM without `persistence.xml` (recommended)
  
  More often than not, you need one _persistence unit_ with few configuration options.
  In {project-name}, you just need to:
  
  * add your settings in `{config-file}`
  * annotate your entities with `@Entity` and friends
  
  and we make some opinionated choices and educated guesses.
  
  In your `pom.xml`, add the following dependencies:
  
  * JPA extension
  * Agroal extension (the database connection pool)
  * your JDBC driver extension (`jdbc-postgresql-deployment`, `jdbc-h2-deployment`, `jdbc-mariadb-deployment`, ...)
  * and generic {project-name} extensions: CDI (arc)
  
  [source,xml]
  --
  