From 5192cb1ed6e0114fc564da7e5d02c410b3739fd6 Mon Sep 17 00:00:00 2001 From: Jay Bryant Date: Thu, 25 Jun 2020 15:03:07 -0500 Subject: [PATCH] Wording changes Removed the language of oppression and violence and replaced it with more neutral language. Note that problematic words in the code have to remain in the docs until the code changes. --- src/main/asciidoc/customizing-json-output.adoc | 2 +- src/main/asciidoc/etags-and-other-conditionals.adoc | 2 +- src/main/asciidoc/metadata.adoc | 2 +- src/main/asciidoc/repository-resources.adoc | 2 +- src/main/asciidoc/spring-data-rest-examples.adoc | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/src/main/asciidoc/customizing-json-output.adoc b/src/main/asciidoc/customizing-json-output.adoc index 3e1419e702..cd6bb20205 100644 --- a/src/main/asciidoc/customizing-json-output.adoc +++ b/src/main/asciidoc/customizing-json-output.adoc @@ -36,6 +36,6 @@ You can add links to the default representation of an entity by calling `resourc == Customizing the Representation -The Spring Data REST exporter executes any discovered `ResourceProcessor` instances before it creates the output representation. It does so by registering a `Converter` instance with an internal `ConversionService`. This is the component responsible for creating the links to referenced entities (such as those objects under the `_links` property in the object's JSON representation). It takes an `@Entity` and iterates over its properties, creating links for those properties that are managed by a `Repository` and copying across any embedded or simple properties. +The Spring Data REST exporter runs any discovered `ResourceProcessor` instances before it creates the output representation. It does so by registering a `Converter` instance with an internal `ConversionService`. This is the component responsible for creating the links to referenced entities (such as those objects under the `_links` property in the object's JSON representation). It takes an `@Entity` and iterates over its properties, creating links for those properties that are managed by a `Repository` and copying across any embedded or simple properties. If your project needs to have output in a different format, however, you can completely replace the default outgoing JSON representation with your own. If you register your own `ConversionService` in the `ApplicationContext` and register your own `Converter`, you can return a `Resource` implementation of your choosing. diff --git a/src/main/asciidoc/etags-and-other-conditionals.adoc b/src/main/asciidoc/etags-and-other-conditionals.adoc index 4aa9185ccd..ac508cd067 100644 --- a/src/main/asciidoc/etags-and-other-conditionals.adoc +++ b/src/main/asciidoc/etags-and-other-conditionals.adoc @@ -43,7 +43,7 @@ curl -v -H 'If-None-Match: ' ... ---- ==== -The preceding command (by default) executes a `GET`. Spring Data REST checks for `If-None-Match` headers while doing a `GET`. If the header matches the ETag, it concludes that nothing has changed and, instead of sending a copy of the resource, sends back an HTTP `304 Not Modified` status code. Semantically, it reads "`If this supplied header value does not match the server-side version, send the whole resource. Otherwise, do not send anything.`" +The preceding command (by default) runs a `GET`. Spring Data REST checks for `If-None-Match` headers while doing a `GET`. If the header matches the ETag, it concludes that nothing has changed and, instead of sending a copy of the resource, sends back an HTTP `304 Not Modified` status code. Semantically, it reads "`If this supplied header value does not match the server-side version, send the whole resource. Otherwise, do not send anything.`" NOTE: This POJO is from an `ETag`-based unit test, so it does not have `@Entity` (JPA) or `@Document` (MongoDB) annotations, as expected in application code. It focuses solely on how a field with `@Version` results in an `ETag` header. diff --git a/src/main/asciidoc/metadata.adoc b/src/main/asciidoc/metadata.adoc index 8dabe4b3d6..bc7c43f7b3 100644 --- a/src/main/asciidoc/metadata.adoc +++ b/src/main/asciidoc/metadata.adoc @@ -342,7 +342,7 @@ As shown in the <>, you can reach this data by n These links are the same as shown earlier. To retrieve JSON Schema, you can invoke them with the following `Accept` header: `application/schema+json`. -In this case, if you executed `curl -H 'Accept:application/schema+json' http://localhost:8080/profile/persons`, you would see output resembling the following: +In this case, if you ran `curl -H 'Accept:application/schema+json' http://localhost:8080/profile/persons`, you would see output resembling the following: ==== [source,javascript] diff --git a/src/main/asciidoc/repository-resources.adoc b/src/main/asciidoc/repository-resources.adoc index 962d6d6c12..15c88ce5e4 100644 --- a/src/main/asciidoc/repository-resources.adoc +++ b/src/main/asciidoc/repository-resources.adoc @@ -384,7 +384,7 @@ As the search resource is a read-only resource, it supports `GET` only. ==== `GET` -The `GET` method returns the result of the query execution. +The `GET` method returns the result of the query. ===== Parameters diff --git a/src/main/asciidoc/spring-data-rest-examples.adoc b/src/main/asciidoc/spring-data-rest-examples.adoc index 90217d7f50..81c441a095 100644 --- a/src/main/asciidoc/spring-data-rest-examples.adoc +++ b/src/main/asciidoc/spring-data-rest-examples.adoc @@ -24,4 +24,4 @@ https://github.com/spring-projects/spring-data-examples/tree/master/rest/securit [[spring-data-examples.starbucks]] == Starbucks example -https://github.com/spring-projects/spring-data-examples/tree/master/rest/starbucks[This example] exposes 10,843 Starbucks coffee shops through a RESTful API that allows access to the stores in a hypermedia-based way and exposes a resource to execute a geo-location search for coffee shops. +https://github.com/spring-projects/spring-data-examples/tree/master/rest/starbucks[This example] exposes 10,843 Starbucks coffee shops through a RESTful API that allows access to the stores in a hypermedia-based way and exposes a resource to run a geo-location search for coffee shops.