From 1ef8390791991ede7307ceff8951d1ad4bdd873c Mon Sep 17 00:00:00 2001
From: John Blum <jblum@pivotal.io>
Date: Fri, 22 Jun 2018 14:44:22 -0700
Subject: [PATCH] Move section on using Spring Boot for Apache Geode/Pivotal
 GemFire, Maven and Gradle build configuration to index.adoc.

---
 spring-geode-docs/spring-geode-docs.gradle    |  5 +-
 .../asciidoc/clientcache-applications.adoc    | 30 +-----
 .../src/docs/asciidoc/index.adoc              | 93 ++++++++++++++++++-
 3 files changed, 99 insertions(+), 29 deletions(-)

diff --git a/spring-geode-docs/spring-geode-docs.gradle b/spring-geode-docs/spring-geode-docs.gradle
index 7d738488..c7980b1e 100644
--- a/spring-geode-docs/spring-geode-docs.gradle
+++ b/spring-geode-docs/spring-geode-docs.gradle
@@ -25,11 +25,12 @@ asciidoctor {
 	def githubTag = snapshotBuild ? 'master' : project.version
 	def githubUrl = "$githubBaseUrl/tree/$githubTag"
 
-	attributes 'version-snapshot': snapshotBuild,
+	attributes 'version' : project.version,
+	    'version-snapshot': snapshotBuild,
 		'version-milestone': milestoneBuild,
 		'version-release': releaseBuild,
-		'github-url': githubUrl,
 		'download-url' : "${githubBaseUrl}/archive/${githubTag}.zip",
+		'github-url': githubUrl,
 		'spring-version' : versions['org.springframework:spring-core'],
 		'spring-boot-version' : "${springBootVersion}",
 		'spring-boot-data-geode-version' : project.version,
diff --git a/spring-geode-docs/src/docs/asciidoc/clientcache-applications.adoc b/spring-geode-docs/src/docs/asciidoc/clientcache-applications.adoc
index a2d7464e..224d42c4 100644
--- a/spring-geode-docs/src/docs/asciidoc/clientcache-applications.adoc
+++ b/spring-geode-docs/src/docs/asciidoc/clientcache-applications.adoc
@@ -7,33 +7,11 @@ simply by putting either Spring Boot for Apache Geode or Pivotal GemFire on your
 
 It is assumed that most developers using Spring Boot to build applications backed by either Apache Geode
 or Pivotal GemFire will be building Spring cache client applications in Apache Geode/Pivotal GemFire's
-{apache-geode-docs}/topologies_and_comm/cs_configuration/chapter_overview.html[Client/Server Configuration]
-and topology.  This is the most common and traditional arrangement employed in most application system architectures.
+{apache-geode-docs}/topologies_and_comm/cs_configuration/chapter_overview.html[Client/Server configuration]
+and topology.  This is the most common and traditional arrangement employed by most application system architectures.
 
-For example, declare the `spring-geode-starter` on your application classpath:
-
-.Maven
-[source,xml]
-----
-<dependencies>
-    <dependency>
-        <groupId>org.springframework.geode</groupId>
-        <artifactId>spring-geode-starter</artifactId>
-        <version>{spring-boot-data-geode-version}</version>
-    </dependency>
-</dependencies
-----
-
-.Grade
-[source,groovy]
-----
-compile 'org.springframework.geode:spring-geode-starter:{spring-boot-data-geode-version}'
-----
-
-TIP: To use Pivotal GemFire in place of Apache Geode, simply change the `artifactId` from `spring-geode-starter`
-to `spring-gemfire-starter`.
-
-Then, build your Spring Boot application:
+For example, build your Spring Boot, Apache Geode/Pivotal GemFire, `ClientCache` application with either
+the `spring-geode-starter` or `spring-gemfire-starter`, respectively on application classpath, and then:
 
 .Spring Boot, Apache Geode/Pivotal GemFire ClientCache Application
 [source,java]
diff --git a/spring-geode-docs/src/docs/asciidoc/index.adoc b/spring-geode-docs/src/docs/asciidoc/index.adoc
index ab390985..f6dea52d 100644
--- a/spring-geode-docs/src/docs/asciidoc/index.adoc
+++ b/spring-geode-docs/src/docs/asciidoc/index.adoc
@@ -1,8 +1,11 @@
 = Spring Boot for Apache Geode & Pivotal GemFire Reference Guide
-John Blum
+John Blum;
+:revnumber: {version}
+:revdate: {localdate}
 :doctype: book
 :toc:
 :toclevels: 4
+:!toc-placement:
 :source-highlighter: prettify
 :numbered:
 :icons: font
@@ -26,6 +29,14 @@ John Blum
 :spring-framework-javadoc: https://docs.spring.io/spring/docs/current/javadoc-api
 :wikipedia-docs: https://en.wikipedia.org/wiki
 
+(C) 2018 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.
+
+toc::[]
+
 [[abstract]]
 Welcome to _Spring Boot for Apache Geode & Pivotal GemFire_.
 
@@ -105,6 +116,86 @@ As such, it would be pertinent to begin your Spring Boot education {spring-boot-
 
 Finally, we arrive at Spring Boot for Apache Geode & Pivotal GemFire.
 
+[[maven-gradle]]
+== Using Spring Boot for Apache Geode or Pivotal GemFire
+
+To use Spring Boot for Apache Geode, declare the `spring-geode-starter` on your application classpath:
+
+.Maven
+[source,xml]
+[subs="verbatim,attributes"]
+----
+<dependencies>
+    <dependency>
+        <groupId>org.springframework.geode</groupId>
+        <artifactId>spring-geode-starter</artifactId>
+        <version>{spring-boot-data-geode-version}</version>
+    </dependency>
+</dependencies
+----
+
+.Grade
+[source,groovy]
+[subs="verbatim,attributes"]
+----
+compile 'org.springframework.geode:spring-geode-starter:{spring-boot-data-geode-version}'
+----
+
+TIP: To use Pivotal GemFire in place of Apache Geode, simply change the `artifactId` from `spring-geode-starter`
+to `spring-gemfire-starter`.
+
+ifeval::["{version-snapshot}" == "true"]
+Since we are using a SNAPSHOT version, we need to add the _Spring_ Snapshot Maven Repository.
+If you are using _Maven_, include the following `repository` declaration in your `pom.xml`:
+
+.Maven
+[source,xml]
+----
+<repositories>
+    <repository>
+        <id>spring-snapshot</id>
+        <url>https://repo.spring.io/libs-snapshot</url>
+    </repository>
+</repositories>
+----
+
+If you are using _Gradle_, include the following `repository` declaration in your `build.gradle`:
+
+.Gradle
+[source,gradle]
+----
+repositories {
+    maven { url: 'https://repo.spring.io/libs-snapshot' }
+}
+----
+endif::[]
+
+ifeval::["{version-milestone}" == "true"]
+Since we are using a Milestone version, we need to add the _Spring_ Milestone Maven Repository.
+If you are using _Maven_, include the following `repository` declaration in your `pom.xml`:
+
+.Maven
+[source,xml]
+----
+<repositories>
+    <repository>
+        <id>spring-milestone</id>
+        <url>https://repo.spring.io/libs-milestone</url>
+    </repository>
+</repositories>
+----
+
+If you are using _Gradle_, include the following `repository` declaration in your `build.gradle`:
+
+.Gradle
+[source,gradle]
+----
+repositories {
+    maven { url: 'https://repo.spring.io/libs-milestone' }
+}
+endif::[]
+
 include::clientcache-applications.adoc[]
 include::caching.adoc[]
 include::repositories.adoc[]
+include::functions.adoc[]