diff --git a/spring-geode-docs/src/docs/asciidoc/index.adoc b/spring-geode-docs/src/docs/asciidoc/index.adoc index f6fbfc56..ab390985 100644 --- a/spring-geode-docs/src/docs/asciidoc/index.adoc +++ b/spring-geode-docs/src/docs/asciidoc/index.adoc @@ -47,32 +47,28 @@ built into Spring Data for Apache Geode/Pivotal GemFire (SDG) as of the Spring D [[introduction]] == Introduction -Spring Boot for Apache Geode & Pivotal GemFire automatically applies auto-configuration support for several key +Spring Boot for Apache Geode & Pivotal GemFire automatically applies _auto-configuration_ for several key application concerns, or _Use Cases_, including, but not limited to: * _Look-Aside Caching_, using either Apache Geode or Pivotal GemFire as the caching provider in {spring-framework-docs}/integration.html#cache[Spring's Cache Abstraction]. -* Using Apache Geode or Pivotal GemFire as a {wikipedia-docs}/System_of_record[_System of Record_ (SOR)] to persist -application state consistently and reliably with {spring-data-commons-docs-html}/#repositories[Spring Data Repositories]. -* Running _distributed computations_ with Apache Geode/Pivotal GemFire's -{apache-geode-docs}/developing/function_exec/chapter_overview.html[Function Execution API], -conveniently invoked with Spring Data for Apache Geode/Pivotal GemFire -{spring-data-geode-docs-html}/#function-annotations[POJO-based, Annotation Support for Function Executions & Implementations]. -* Registering interests in and reacting to a stream of events with Apache Geode/Pivotal GemFire -{apache-geode-docs}/developing/continuous_querying/chapter_overview.html[Continuous Query (CQ)] -where process handlers can be defined as simple Message-Driven POJOs (MDP) using Spring's -{spring-framework-docs}/integration.html#jms-mdp[Message Listener Container], -which is {spring-data-geode-docs-html}/#bootstrap-annotation-config-continuous-queries[configurable] -and {spring-data-geode-docs-html}/#apis:continuous-query[implemented] -in Spring Data for Apache Geode/Pivotal GemFire CQ. -* Data Serialization with Apache Geode/Pivotal GemFire {apache-geode-docs}/developing/data_serialization/gemfire_pdx_serialization.html[PDX] -for which Spring Data for Apache Geode/Pivotal GemFire provides first-class -{spring-data-geode-docs-html}/#bootstrap-annotation-config-pdx[configuration] +* {wikipedia-docs}/System_of_record[_System of Record_ (SOR)], persisting application state in Apache Geode +or Pivotal GemFire consistently and reliably using {spring-data-commons-docs-html}/#repositories[Spring Data Repositories]. +* _Distributed Computations_, run with Apache Geode/Pivotal GemFire's +{apache-geode-docs}/developing/function_exec/chapter_overview.html[Function framework], +conveniently implemented and executed with Spring Data for Apache Geode/Pivotal GemFire +{spring-data-geode-docs-html}/#function-annotations[POJO, annotation-based Function Executions & Implementations]. +* _Continuous Queries_, expressing interests in a stream of events, where applications are able to react to and process +changes to data in near real-time using Apache Geode/Pivotal GemFire {apache-geode-docs}/developing/continuous_querying/chapter_overview.html[Continuous Query (CQ)]. +Process handlers can be defined as simple Message-Driven POJOs (MDP) using Spring's {spring-framework-docs}/integration.html#jms-mdp[Message Listener Container], +which is {spring-data-geode-docs-html}/#bootstrap-annotation-config-continuous-queries[configurable] and {spring-data-geode-docs-html}/#apis:continuous-query[implemented] +in Spring Data for Apache Geode/Pivotal GemFire CQ support. +* _Data Serialization_ with Apache Geode/Pivotal GemFire {apache-geode-docs}/developing/data_serialization/gemfire_pdx_serialization.html[PDX] +for which Spring Data for Apache Geode/Pivotal GemFire provides first-class {spring-data-geode-docs-html}/#bootstrap-annotation-config-pdx[configuration] and {spring-data-geode-docs-html}/#mapping.pdx-serializer[support]. -* Security, encompassing all aspects of the term, including -{apache-geode-docs}/managing/security/authentication_overview.html[Authentication]/{apache-geode-docs}/managing/security/authorization_overview.html[Authorization] -as well as Transport Layer Security (TLS) using Apache Geode/Pivotal GemFire's -{apache-geode-docs}/managing/security/ssl_overview.html[Secure Socket Layer (SSL)]. +* _Security_, encompassing all aspects of the term, including +{apache-geode-docs}/managing/security/authentication_overview.html[Authentication] / {apache-geode-docs}/managing/security/authorization_overview.html[Authorization] +as well as Transport Layer Security (TLS) using Apache Geode/Pivotal GemFire's {apache-geode-docs}/managing/security/ssl_overview.html[Secure Socket Layer (SSL)]. And, once again, Spring Data for Apache Geode/Pivotal GemFire has you covered with both {spring-data-geode-docs-html}/#bootstrap-annotation-config-security[Auth] and {spring-data-geode-docs-html}/#bootstrap-annotation-config-ssl[SSL]. @@ -83,23 +79,27 @@ configuring all these really powerful Apache Geode/Pivotal GemFire features, Spr [[getting-started]] == Getting Started -In order to be effective with and productive using Spring Boot for Apache Geode/Pivotal GemFire, it is helpful +In order to be as effective as possible and productive with Spring Boot for Apache Geode/Pivotal GemFire, it is helpful to understand the foundation on which this project was built. -Of course, our story begins with the core Spring Framework itself, and specifically, the foundation laid down -by the Spring container's {spring-framework-docs}/core.html#spring-core[core technologies and concepts]. +Of course, our story begins with the core Spring Framework and specifically the foundation laid down by +the Spring container's {spring-framework-docs}/core.html#spring-core[core technologies and concepts]. Then, our journey continues with the extensions built into Spring Data for Apache Geode & Pivotal GemFire (SDG) to truly -simplify the development of GemFire/Geode applications in a Spring context, using Spring's powerful and highly consistent -programming model. This part of the story was greatly enhanced in Spring Data Kay, with SDG's new -{spring-data-geode-docs-html}/#bootstrap-annotation-config[configuration model using annotations]. -Though this new annotation-based configuration approach provides sensible defaults out-of-the-box, its use -is very explicit and it assumes nothing. That is, you still must tell SDG what you want. +simplify the development of Apache Geode & Pivotal GemFire applications in a Spring context, using Spring's powerful +and highly consistent programming model. + +This part of the story was greatly enhanced in Spring Data *Kay*, with SDG's new +{spring-data-geode-docs-html}/#bootstrap-annotation-config[annotation-based configuration model]. +Though this new configuration approach using annotations provides sensible defaults out-of-the-box, its use +is also very explicit and it assumes nothing. That is, you still must tell SDG what you want. Next, we venture into Spring Boot and all of its wonderfully expressive and highly opinionated "_convention over configuration_" -approach for getting the most out of your Spring GemFire/Geode-based applications in the quickest/easiest way possible. -We do that by combining Spring Data for Apache Geode/Pivotal GemFire's Annotation-based Configuration with Spring Boot -using "_auto-configuration_" to get you going even faster and more reliably so that you are productive from the start. +approach for getting the most out of your Spring, Apache Geode or Pivotal GemFire based applications in the quickest/easiest way +possible. We accomplish this by combining Spring Data for Apache Geode/Pivotal GemFire's +{spring-data-geode-docs-html}/#bootstrap-annotation-config[annotation-based configuration] with Spring Boot's +{spring-boot-docs-html}/#using-boot-auto-configuration[auto-configuration] to get you up and running even faster +and more reliably so that you are productive from the start. As such, it would be pertinent to begin your Spring Boot education {spring-boot-docs-html}/#getting-started[here].