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[].
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