HHH-17082 - Improve documentation of configuration settings

https://hibernate.atlassian.net/browse/HHH-17082
(cherry picked from commit fd961ce)

Author: beikov

documentation/src/main/asciidoc/shared/common-attributes.adoc

@@ -1,3 +1,3 @@
 
 // NOTE : majorMinorVersion is injected by the build and will override this value
-:majorMinorVersion: 6.3
+:majorMinorVersion: 6.2

documentation/src/main/asciidoc/userguide/Bibliography.adoc

@@ -1,6 +1,5 @@
-== References
-
 [bibliography]
+== References
 - [[[PoEAA]]] Martin Fowler. https://www.martinfowler.com/books/eaa.html[Patterns of Enterprise Application Architecture].
   Addison-Wesley Professional. 2002.
 - [[[JPwH]]] Christian Bauer & Gavin King. https://www.manning.com/books/java-persistence-with-hibernate-second-edition[Java Persistence with Hibernate, Second Edition]. Manning Publications Co. 2015.

documentation/src/main/asciidoc/userguide/ConfigPropertyList.adoc

@@ -39,17 +39,13 @@ include::chapters/beans/Beans.adoc[]
 include::chapters/portability/Portability.adoc[]
 include::chapters/statistics/Statistics.adoc[]
 include::chapters/tooling/Tooling.adoc[]
-
-include::appendices/Configurations.adoc[]
-include::appendices/Annotations.adoc[]
 include::appendices/BestPractices.adoc[]
-include::appendices/Legacy_Bootstrap.adoc[]
-include::appendices/Legacy_DomainModel.adoc[]
-include::appendices/LegacyBasicTypeResolution.adoc[]
-include::appendices/Legacy_Native_Queries.adoc[]
 
 include::Credits.adoc[]
 
-include::ConfigPropertyList.adoc[]
+include::appendices/SettingsReference.adoc[]
+include::appendices/LegacyBasicTypeResolution.adoc[]
+include::appendices/Legacy_Native_Queries.adoc[]
+
 include::Bibliography.adoc[]
 

documentation/src/main/asciidoc/userguide/Hibernate_User_Guide.adoc

@@ -258,8 +258,3 @@ For this reason, `NONSTRICT_READ_WRITE` is not very suitable if entities are cha
 When using clustering, the second-level cache entries are spread across multiple nodes.
 When using https://infinispan.org/blog/2015/10/01/hibernate-second-level-cache/[Infinispan distributed cache], only `READ_WRITE` and `NONSTRICT_READ_WRITE` are available for read-write caches.
 Bear in mind that `NONSTRICT_READ_WRITE` offers a weaker consistency guarantee since stale updates are possible.
-
-[NOTE]
-====
-For more about Hibernate Performance Tuning, check out the https://www.youtube.com/watch?v=BTdTEe9QL5k&t=1s[High-Performance Hibernate] presentation from Devoxx France.
-====

documentation/src/main/asciidoc/userguide/appendices/Annotations.adoc

@@ -4,6 +4,7 @@
 :extrasdir: extras
 :originalextrasdir: ../chapters/domain/extras
 
+[appendix]
 [[basic-legacy]]
 == Legacy BasicType resolution
 

documentation/src/main/asciidoc/userguide/appendices/BestPractices.adoc

@@ -1,3 +1,4 @@
+[appendix]
 [[appendix-legacy-native-queries]]
 == Legacy Hibernate Native Queries