diff --git a/spring-geode-docs/src/docs/asciidoc/guides/getting-started.adoc b/spring-geode-docs/src/docs/asciidoc/guides/getting-started.adoc index 95c8e33f..bbcadd52 100644 --- a/spring-geode-docs/src/docs/asciidoc/guides/getting-started.adoc +++ b/spring-geode-docs/src/docs/asciidoc/guides/getting-started.adoc @@ -59,16 +59,22 @@ link:../index.html#geode-samples[Back] First, open your Web browser to https://start.spring.io[]. -Then select: +Then select (for example): -* Maven Project (alternatively, you can select _Gradle_ if you prefer) -* Java Language (alternatively, you can use Kotlin, or Groovy) -* Spring Boot {spring-boot-version} -* Project Metadata: -** Group: `example.app` -** Artifact: `crm` -* Add Dependency: "_Spring for Apache Geode_" by typing "_Geode_" into the "_Search dependencies to add_" field. -* Optionally Add Dependency: "_Spring Web_" to pull in `org.springframework.boot:spring-boot-starter-web`. +* _Project_: **Maven Project** (alternatively, you can select "_Gradle Project_") +* _Language_: **Java** (alternatively, you can use "_Kotlin_", or "_Groovy_") +* _Spring Boot_: **2.2.0 M6** (if `2.2.0 M6` is not available, select the latest, non-BUILD-SNAPSHOT version) +* _Project Metadata_: +** _Group_: **example.app** +** _Artifact_: **crm** +* _Dependencies_: Add "**Spring for Apache Geode**" by typing "_Geode_" into the "_Search dependencies to add_" +text field. +* (Optional) _Dependencies_: Add "_Spring Web_" to pull in `org.springframework.boot:spring-boot-starter-web` +if you want this Spring Boot application to be a Web application. + +TIP: Use this https://start.spring.io/#!platformVersion={spring-boot-version}&groupId=example.app&artifactId=crm&dependencies=geode[link], +to select all the options above and include the "_Spring for Apache Geode_" dependency along with the Spring Boot +version matching "this" version of Spring Boot for Apache Geode (SBDG). The Spring Boot version may not be `2.2.0.M6`. Your selections should look similar to: @@ -90,6 +96,17 @@ or https://spring.io/tools[Spring Tool Suite] (STS)) to open the generated proje You are ready to begin developing your Spring Boot, Apache Geode `ClientCache` application. +.Versions +***** +The screenshots of _Spring Initializer_ at https://starter.spring.io[start.spring.io] were taken when Spring Boot +`2.2.0.M6` was the current release. You should always choose to use the latest version of Spring Boot in a particular +release line, whether that is `2.1.x`, `2.2.x`, `2.3.x`, `3.x` or beyond. + +SBDG minor versions will always match minor versions of Spring Boot. The SBDG major version will always be one version +behind. For example, SBDG 1.1 is based on Spring Boot 2.1. SBDG 1.2 is based on Spring Boot 2.2. And, SBDG 1.3 will +be based on Spring Boot 2.3. When Spring Boot reaches 3.0, SBDG will be at 2.0, and so on. +***** + [[geode-samples-getting-started-spring-initializer-explore-run]] === Exploring the Source Code and Running the CrmApplication