From 1fa10e3b53604cae92bd7d5197da4cd21a660e4c Mon Sep 17 00:00:00 2001
From: Gavin King <gavin@hibernate.org>
Date: Wed, 23 Oct 2024 21:17:26 +0200
Subject: [PATCH] update prefaces

Signed-off-by: Gavin King <gavin@hibernate.org>
---
 .../src/main/asciidoc/querylanguage/Concepts.adoc  |  4 ++--
 .../src/main/asciidoc/querylanguage/Preface.adoc   | 14 +++++++-------
 .../src/main/asciidoc/repositories/Preface.adoc    |  7 ++++++-
 3 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/documentation/src/main/asciidoc/querylanguage/Concepts.adoc b/documentation/src/main/asciidoc/querylanguage/Concepts.adoc
index 61d782d922..7626703e88 100644
--- a/documentation/src/main/asciidoc/querylanguage/Concepts.adoc
+++ b/documentation/src/main/asciidoc/querylanguage/Concepts.adoc
@@ -645,8 +645,8 @@ List<Object[]> results =
                                   Object[].class)
             .getResultList();
 for (var result : results) {
-	String title = (String) result[0];
-	String preamble = (String) result[1];
+    String title = (String) result[0];
+    String preamble = (String) result[1];
 }
 ----
 
diff --git a/documentation/src/main/asciidoc/querylanguage/Preface.adoc b/documentation/src/main/asciidoc/querylanguage/Preface.adoc
index 4976e23c64..34c670738e 100644
--- a/documentation/src/main/asciidoc/querylanguage/Preface.adoc
+++ b/documentation/src/main/asciidoc/querylanguage/Preface.adoc
@@ -5,14 +5,14 @@ include::{shared-attributes-dir}/url-attributes.adoc[]
 [[preface]]
 == Preface
 
-Hibernate 6 is a major redesign of the world's most popular and feature-rich ORM solution.
-The redesign has touched almost every subsystem of Hibernate, including the APIs, mapping annotations, and, above all else, the query language.
+Hibernate 6 was a major redesign of the world's most popular and feature-rich ORM solution.
+The redesign touched almost every subsystem of Hibernate, including the APIs, mapping annotations, and, above all else, the query language.
+This was the second time Hibernate Query Language had been completely reimplemented from scratch, but the first time in more than fifteen years.
+Hibernate 7 rests on this foundation.
 
-This is the second time Hibernate Query Language has been completely reimplemented from scratch, but the first time in more than fifteen years.
 In this new incarnation, HQL is far more powerful, and the HQL compiler much more robust.
+Today, HQL has a feature set to match that of modern dialects of SQL, and is able to take full advantage of the power of modern SQL databases.
 
-At long last, HQL has a feature set to match that of modern dialects of SQL, and is able to take full advantage of the power of modern SQL databases.
+This document is a reference guide to the full feature set of the language, and is the only up-to-date source for those who wish to learn how to write HQL effectively in Hibernate 6 and Hibernate 7.
 
-This document is a reference guide to the full feature set of the language, and is the only up-to-date source for those who wish to learn how to write HQL effectively in Hibernate 6.
-
-If you are unfamiliar with Hibernate, be sure to first read  link:{doc-introduction-url}[Introduction to Hibernate] or check out the link:{doc-quick-start-url}[Quick Start].
+If you are unfamiliar with Hibernate, be sure to first read the link:{doc-introduction-url}[Short Guide to Hibernate].
diff --git a/documentation/src/main/asciidoc/repositories/Preface.adoc b/documentation/src/main/asciidoc/repositories/Preface.adoc
index 81e76a50a0..0c2ee6d8b9 100644
--- a/documentation/src/main/asciidoc/repositories/Preface.adoc
+++ b/documentation/src/main/asciidoc/repositories/Preface.adoc
@@ -16,4 +16,9 @@ On the other hand, the programming model for interacting with the database is qu
 Therefore, this document will show you a different way to use Hibernate.
 
 The coverage of Jakarta Data is intentionally inexhaustive.
-If exhaustion is sought, this document should be read in conjunction with the specification, which we've worked hard to keep readable.
\ No newline at end of file
+If exhaustion is sought, this document should be read in conjunction with the specification, which we've worked hard to keep readable.
+
+If you are unfamiliar with Hibernate, this document should be read in conjunction with:
+
+- the link:{doc-introduction-url}[Short Guide to Hibernate], and
+- the link:{doc-query-language-url}[Guide to Hibernate Query Language].