Fix Errors & Warnings

Author: rwinch

.gitignore

@@ -14,4 +14,8 @@ src/ant/.ant-targets-upload-dist.xml
 *.ipr
 *.iws
 /.idea/
-*.graphml
+*.graphml
+node
+node_modules
+package-lock.json
+package.json

modules/ROOT/nav.adoc

@@ -11,7 +11,6 @@
 ** xref:repositories/custom-implementations.adoc[]
 ** xref:repositories/core-domain-events.adoc[]
 ** xref:repositories/core-extensions.adoc[]
-* xref:repositories-paging-sorting.adoc[]
 * xref:repositories-scrolling.adoc[]
 * xref:repositories-null-handling.adoc[]
 * xref:repository-projections.adoc[]

modules/ROOT/pages/custom-conversions.adoc

@@ -1,3 +1,5 @@
+= Custom Conversions
+
 The following example of a Spring `Converter` implementation converts from a `String` to a custom `Email` value object:
 
 [source,java,subs="verbatim,attributes"]
@@ -25,7 +27,7 @@ Converters are subject to explicit registration as instances are not picked up f
 NOTE: Default converters for local temporal types (e.g. `LocalDateTime` to `java.util.Date`) rely on system-default timezone settings to convert between those types. You can override the default converter, by registering your own converter.
 
 [[customconversions.converter-disambiguation]]
-= Converter Disambiguation
+== Converter Disambiguation
 
 Generally, we inspect the `Converter` implementations for the source and target types they convert from and to.
 Depending on whether one of those is a type the underlying data access API can handle natively, we register the converter instance as a reading or a writing converter.

modules/ROOT/pages/dependencies.adoc

@@ -24,7 +24,7 @@ Due to the different inception dates of individual Spring Data modules, most of
 [[dependencies.train-names]]
 [[dependencies.train-version]]
 The current release train version is `{releasetrainVersion}`. The train version uses https://calver.org/[calver] with the pattern `YYYY.MINOR.MICRO`.
-The version name follows `${calver}` for GA releases and service releases and the following pattern for all other versions: `${calver}-${modifier}`, where `modifier` can be one of the following:
+The version name follows `+${calver}+` for GA releases and service releases and the following pattern for all other versions: `+${calver}-${modifier}+`, where `modifier` can be one of the following:
 
 * `SNAPSHOT`: Current snapshots
 * `M1`, `M2`, and so on: Milestones

modules/ROOT/pages/entity-callbacks.adoc

@@ -36,7 +36,9 @@ public interface BeforeSaveCallback<T> extends EntityCallback<T> {
 	 *
 	 * @return the domain object to be persisted.
 	 */
-	T onBeforeSave(T entity <2>, String collection <3>); <1>
+	// <1>
+	T onBeforeSave(T entity, // <2>
+		String collection); // <3>
 }
 ----
 <1> `BeforeSaveCallback` specific method to be called before an entity is saved. Returns a potentially modifed instance.
@@ -57,7 +59,9 @@ public interface ReactiveBeforeSaveCallback<T> extends EntityCallback<T> {
 	 *
 	 * @return Publisher emitting the domain object to be persisted.
 	 */
-	Publisher<T> onBeforeSave(T entity <2>, String collection <3>); <1>
+	// <1>
+	Publisher<T> onBeforeSave(T entity, // <2>
+		String collection); // <3>
 }
 ----
 <1> `BeforeSaveCallback` specific method to be called on subscription, before an entity is saved. Emits a potentially modifed instance.

modules/ROOT/pages/index.adoc

@@ -1,5 +1,5 @@
 [[spring-data-commons-reference-documentation]]
-= Spring Data Commons - Reference Documentation
+= Spring Data Commons
 Oliver Gierke; Thomas Darimont; Christoph Strobl; Mark Pollack; Thomas Risberg; Mark Paluch; Jay Bryant
 :revnumber: {version}
 :revdate: {localdate}
@@ -9,24 +9,3 @@ ifdef::backend-epub3[:front-cover-image: image:epub-cover.png[Front Cover,1050,1
 (C) 2008-2022 The original authors.
 
 NOTE: Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.
-
-
-[[reference-documentation]]
-= Reference Documentation
-
-:leveloffset: +1
-
-
-
-
-
-
-
-:leveloffset: -1
-
-[[appendix]]
-= Appendices
-
-:numbered!:
-:leveloffset: +1
-:leveloffset: -1

modules/ROOT/pages/repositories-paging-sorting.adoc

@@ -3,7 +3,7 @@
 
 Scrolling is a more fine-grained approach to iterate through larger results set chunks.
 Scrolling consists of a stable sort, a scroll type (Offset- or Keyset-based scrolling) and result limiting.
-You can define simple sorting expressions by using property names and define static result limiting using the xref:repositories-paging-sorting.adoc#repositories.limit-query-result[`Top` or `First` keyword] through query derivation.
+You can define simple sorting expressions by using property names and define static result limiting using the xref:repositories/query-methods-details.adoc#repositories.limit-query-result[`Top` or `First` keyword] through query derivation.
 You can concatenate expressions to collect multiple criteria into one expression.
 
 Scroll queries return a `Window<T>` that allows obtaining the scroll position to resume to obtain the next `Window<T>` until your application has consumed the entire query result.

modules/ROOT/pages/repositories-scrolling.adoc

@@ -182,7 +182,7 @@ Its `customize()` method gets called, letting you change settings, as the follow
 If setting the properties of an existing `MethodArgumentResolver` is not sufficient for your purpose, extend either `SpringDataWebConfiguration` or the HATEOAS-enabled equivalent, override the `pageableResolver()` or `sortResolver()` methods, and import your customized configuration file instead of using the `@Enable` annotation.
 
 If you need multiple `Pageable` or `Sort` instances to be resolved from the request (for multiple tables, for example), you can use Spring's `@Qualifier` annotation to distinguish one from another.
-The request parameters then have to be prefixed with `${qualifier}_`.
+The request parameters then have to be prefixed with `+${qualifier}_+`.
 The following example shows the resulting method signature:
 
 ====