Improve section on using Spring Initializer at start.spring.io in the 'Getting Started' Guide.

Change the selected options (lables & values) to match the screenshot.

Add sidebar on Spring Boot vs. Spring Boot for Apache Geode versions.
This commit is contained in:
John Blum
2019-10-02 22:01:26 -07:00
parent b356111ed4
commit 7acf3c92c5

View File

@@ -59,16 +59,22 @@ link:../index.html#geode-samples[Back]
First, open your Web browser to https://start.spring.io[]. 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) * _Project_: **Maven Project** (alternatively, you can select "_Gradle Project_")
* Java Language (alternatively, you can use Kotlin, or Groovy) * _Language_: **Java** (alternatively, you can use "_Kotlin_", or "_Groovy_")
* Spring Boot {spring-boot-version} * _Spring Boot_: **2.2.0 M6** (if `2.2.0 M6` is not available, select the latest, non-BUILD-SNAPSHOT version)
* Project Metadata: * _Project Metadata_:
** Group: `example.app` ** _Group_: **example.app**
** Artifact: `crm` ** _Artifact_: **crm**
* Add Dependency: "_Spring for Apache Geode_" by typing "_Geode_" into the "_Search dependencies to add_" field. * _Dependencies_: Add "**Spring for Apache Geode**" by typing "_Geode_" into the "_Search dependencies to add_"
* Optionally Add Dependency: "_Spring Web_" to pull in `org.springframework.boot:spring-boot-starter-web`. 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: 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. 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]] [[geode-samples-getting-started-spring-initializer-explore-run]]
=== Exploring the Source Code and Running the CrmApplication === Exploring the Source Code and Running the CrmApplication