GH-2562 - Restructure documentation.

Especially pull up the parts explaining the differences between SDN6 and SDN+OGM, make the FAQ more visible and have only one appendix in one place.

Closes #2562.

Author: michael-simons

pom.xml

@@ -781,25 +781,13 @@
 								<version>${asciidoctorj-diagram.version}</version>
 							</dependency>
 						</dependencies>
-						<configuration>
-							<backend>html</backend>
-							<doctype>book</doctype>
-							<imagesDir>img</imagesDir>
-							<sourceDirectory>${project.basedir}/src/main/asciidoc</sourceDirectory>
-							<sourceDocumentName>index.adoc</sourceDocumentName>
-							<sourceHighlighter>coderay</sourceHighlighter>
+						<configuration combine.self="append">
 							<attributes>
-								<icons>font</icons>
-								<toc>left</toc>
-								<setanchors/>
-								<idprefix/>
-								<idseparator/>
 								<spring-data-commons-docs>${spring-data-commons-docs.dir}</spring-data-commons-docs>
 							</attributes>
 							<requires>
 								<require>asciidoctor-diagram</require>
 							</requires>
-							<outputDirectory>${project.build.docs}</outputDirectory>
 						</configuration>
 					</plugin>
 				</plugins>

src/main/asciidoc/appendix/conversions.adoc

@@ -1,6 +1,9 @@
 [[conversions]]
 = Conversions
 
+[[build-in.conversions]]
+== Built-in conversions
+
 We support a broad range of conversions out of the box.
 Find the list of supported cypher types in the official drivers manual: https://neo4j.com/docs/driver-manual/current/cypher-values/[Working with Cypher values].
 

src/main/asciidoc/appendix/index.adoc

@@ -1,9 +1,7 @@
-:leveloffset: +1
-
 [[sdn-appendix]]
-= Spring Data Neo4j Appendix
+[appendix]
+= Spring Data Neo4j
 
-:numbered!:
 :leveloffset: +1
 
 include::conversions.adoc[]
@@ -21,4 +19,3 @@ include::migrating.adoc[]
 include::build.adoc[]
 
 :leveloffset: -1
-:leveloffset: -1

src/main/asciidoc/appendix/migrating.adoc

@@ -125,7 +125,7 @@ You're then ready to replace annotations:
 |No replacement, not needed
 
 |`org.springframework.data.neo4j.annotation.QueryResult`
-|Use <<projections.sdn, projections>>; arbitrary result mapping not supported anymore
+|Use <<projections, projections>>; arbitrary result mapping not supported anymore
 
 |===