From f40f4a3179bf3a53c8b540a143b195b7c14dbd75 Mon Sep 17 00:00:00 2001 From: Gavin Date: Tue, 16 May 2023 22:17:17 +0200 Subject: [PATCH] add some more marketing I mean information to doc --- .../src/main/asciidoc/introduction/Introduction.adoc | 2 ++ .../src/main/asciidoc/introduction/Preface.adoc | 12 ++++++++++++ 2 files changed, 14 insertions(+) diff --git a/documentation/src/main/asciidoc/introduction/Introduction.adoc b/documentation/src/main/asciidoc/introduction/Introduction.adoc index 1412571bf4..ea51cb3c32 100644 --- a/documentation/src/main/asciidoc/introduction/Introduction.adoc +++ b/documentation/src/main/asciidoc/introduction/Introduction.adoc @@ -30,6 +30,8 @@ But if Hibernate is making things more difficult, for some particularly tricky p Just because you're using Hibernate for persistence doesn't mean you have to use it for _everything_. ==== +Developers often ask about the relationship between Hibernate and JPA, so let's take a short detour into some history. + [[hibernate-and-jpa]] === Hibernate and JPA diff --git a/documentation/src/main/asciidoc/introduction/Preface.adoc b/documentation/src/main/asciidoc/introduction/Preface.adoc index 02c99dadae..280c66ee5d 100644 --- a/documentation/src/main/asciidoc/introduction/Preface.adoc +++ b/documentation/src/main/asciidoc/introduction/Preface.adoc @@ -7,6 +7,18 @@ Hibernate 6 is a major redesign of the world's most popular and feature-rich ORM The redesign has touched almost every subsystem of Hibernate, including the APIs, mapping annotations, and the query language. This new Hibernate is more powerful, more robust, and more typesafe. +With so many improvements, it's very difficult to summarize the significance of this work. +But the following general themes stand out. +Hibernate 6: + +- finally takes advantage of the advances in relational databases over the past decade, updating the query language to support a raft of new constructs in modern dialects of SQL, +- improves error reporting by more scrupulous validation of queries _before_ access to the database, +- improves the type-safety of O/R mapping annotations and clarifies the separation of API, SPI, and internal implementation +- removes or deprecates legacy APIs, laying the foundation for future evolution, and +- makes far better use of Javadoc, putting much more information at the fingertips of developers. + +Hibernate 6 and Hibernate Reactive are now core components of Quarkus 3, the most exciting new environment for cloud-native development in Java, and Hibernate remains the persistence solution of choice for almost every major Java framework or server. + Unfortunately, the changes in Hibernate 6 have obsoleted much of the information about Hibernate that's available in books, in blog posts, and on stackoverflow. On the other hand, the Hibernate {user-guide}[User Guide] provides a great deal of detail about many aspects of Hibernate, but with so much information to cover, readability is difficult to achieve.