Merge "CRUD: Improve language fallback OAS docs"

Author: jenkins-bot

repo/domains/crud/specs/resources/descriptions/description-with-fallback-for-item.json

@@ -2,7 +2,8 @@
 	"get": {
 		"operationId": "getItemDescriptionWithFallback",
 		"tags": [ "descriptions" ],
-		"summary": "Retrieve an Item's description in a specific language, with language fallback. If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description",
+		"summary": "Retrieve an Item's description in a specific language, with language fallback",
+		"description": "If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description.",
 		"parameters": [
 			{ "$ref": "../../global/parameters.json#/ItemId" },
 			{ "$ref": "../../global/parameters.json#/LanguageCode" },
@@ -14,7 +15,7 @@
 		],
 		"responses": {
 			"200": {
-				"description":"Item's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location",
+				"description": "Item's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location.",
 				"$ref": "./responses.json#/ItemDescription"
 			},
 			"304": { "$ref": "../../global/responses.json#/NotModified" },

repo/domains/crud/specs/resources/descriptions/description-with-fallback-for-property.json

@@ -2,7 +2,8 @@
 	"get": {
 		"operationId": "getPropertyDescriptionWithFallback",
 		"tags": [ "descriptions" ],
-		"summary": "Retrieve a Property's description in a specific language, with language fallback. If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description",
+		"summary": "Retrieve a Property's description in a specific language, with language fallback",
+		"description": "If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description.",
 		"parameters": [
 			{ "$ref": "../../global/parameters.json#/PropertyId" },
 			{ "$ref": "../../global/parameters.json#/LanguageCode" },
@@ -14,7 +15,7 @@
 		],
 		"responses": {
 			"200": {
-				"description": "Property's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location",
+				"description": "Property's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location.",
 				"$ref": "./responses.json#/PropertyDescription"
 			},
 			"304": { "$ref": "../../global/responses.json#/NotModified" },

repo/domains/crud/specs/resources/descriptions/responses.json

@@ -126,7 +126,7 @@
 		}
 	},
 	"DescriptionMovedTemporarily": {
-		"description": "A description in a fallback language exists in the indicated location",
+		"description": "A description in a fallback language exists at the indicated location",
 		"headers": {
 			"Location": {
 				"description": "The URL to which the requested resource has been moved",

repo/domains/crud/specs/resources/labels/label-with-fallback-for-item.json

@@ -2,7 +2,8 @@
 	"get": {
 		"operationId": "getItemLabelWithFallback",
 		"tags": [ "labels" ],
-		"summary": "Retrieve an Item's label in a specific language, with language fallback. If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label",
+		"summary": "Retrieve an Item's label in a specific language, with language fallback",
+		"description": "If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label.",
 		"parameters": [
 			{ "$ref": "../../global/parameters.json#/ItemId" },
 			{ "$ref": "../../global/parameters.json#/LanguageCode" },
@@ -14,7 +15,7 @@
 		],
 		"responses": {
 			"200": {
-				"description": "Item's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location",
+				"description": "Item's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location.",
 				"$ref": "./responses.json#/ItemLabel"
 			},
 			"304": { "$ref": "../../global/responses.json#/NotModified" },

repo/domains/crud/specs/resources/labels/label-with-fallback-for-property.json

@@ -2,7 +2,8 @@
 	"get": {
 		"operationId": "getPropertyLabelWithFallback",
 		"tags": [ "labels" ],
-		"summary": "Retrieve a Property's label in a specific language, with language fallback. If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label",
+		"summary": "Retrieve a Property's label in a specific language, with language fallback",
+		"description": "If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label.",
 		"parameters": [
 			{ "$ref": "../../global/parameters.json#/PropertyId" },
 			{ "$ref": "../../global/parameters.json#/LanguageCode" },
@@ -14,7 +15,7 @@
 		],
 		"responses": {
 			"200": {
-				"description": "Property's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location",
+				"description": "Property's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location.",
 				"$ref": "./responses.json#/PropertyLabel"
 			},
 			"304": { "$ref": "../../global/responses.json#/NotModified" },

repo/domains/crud/specs/resources/labels/responses.json

@@ -126,7 +126,7 @@
 		}
 	},
 	"LabelMovedTemporarily": {
-		"description": "A label in a fallback language exists in the indicated location",
+		"description": "A label in a fallback language exists at the indicated location",
 		"headers": {
 			"Location": {
 				"description": "The URL to which the requested resource has been moved",

repo/rest-api/src/openapi.json

@@ -11506,7 +11506,8 @@
         "tags": [
           "descriptions"
         ],
-        "summary": "Retrieve an Item's description in a specific language, with language fallback. If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description",
+        "summary": "Retrieve an Item's description in a specific language, with language fallback",
+        "description": "If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description.",
         "parameters": [
           {
             "in": "path",
@@ -11592,7 +11593,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Item's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location",
+            "description": "Item's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location.",
             "headers": {
               "ETag": {
                 "description": "Last entity revision number",
@@ -11637,7 +11638,7 @@
             }
           },
           "307": {
-            "description": "A description in a fallback language exists in the indicated location",
+            "description": "A description in a fallback language exists at the indicated location",
             "headers": {
               "Location": {
                 "description": "The URL to which the requested resource has been moved",
@@ -12986,7 +12987,8 @@
         "tags": [
           "descriptions"
         ],
-        "summary": "Retrieve a Property's description in a specific language, with language fallback. If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description",
+        "summary": "Retrieve a Property's description in a specific language, with language fallback",
+        "description": "If a description is defined in the requested language, the API responds with a 200 status code and includes the description in the response payload. If a description only exists in a fallback language, the API returns a 307 status code and provides the location of the description.",
         "parameters": [
           {
             "in": "path",
@@ -13072,7 +13074,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Property's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location",
+            "description": "Property's description in a specific language. If a description only exists in a fallback language, the API returns a 307 status code and provides its location.",
             "headers": {
               "ETag": {
                 "description": "Last entity revision number",
@@ -13117,7 +13119,7 @@
             }
           },
           "307": {
-            "description": "A description in a fallback language exists in the indicated location",
+            "description": "A description in a fallback language exists at the indicated location",
             "headers": {
               "Location": {
                 "description": "The URL to which the requested resource has been moved",
@@ -21077,7 +21079,8 @@
         "tags": [
           "labels"
         ],
-        "summary": "Retrieve an Item's label in a specific language, with language fallback. If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label",
+        "summary": "Retrieve an Item's label in a specific language, with language fallback",
+        "description": "If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label.",
         "parameters": [
           {
             "in": "path",
@@ -21163,7 +21166,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Item's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location",
+            "description": "Item's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location.",
             "headers": {
               "ETag": {
                 "description": "Last entity revision number",
@@ -21208,7 +21211,7 @@
             }
           },
           "307": {
-            "description": "A label in a fallback language exists in the indicated location",
+            "description": "A label in a fallback language exists at the indicated location",
             "headers": {
               "Location": {
                 "description": "The URL to which the requested resource has been moved",
@@ -22558,7 +22561,8 @@
         "tags": [
           "labels"
         ],
-        "summary": "Retrieve a Property's label in a specific language, with language fallback. If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label",
+        "summary": "Retrieve a Property's label in a specific language, with language fallback",
+        "description": "If a label is defined in the requested language, the API responds with a 200 status code and includes the label in the response payload. If a label only exists in a fallback language, the API returns a 307 status code and provides the location of the label.",
         "parameters": [
           {
             "in": "path",
@@ -22644,7 +22648,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Property's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location",
+            "description": "Property's label in a specific language. If a label only exists in a fallback language, the API returns a 307 status code and provides its location.",
             "headers": {
               "ETag": {
                 "description": "Last entity revision number",
@@ -22689,7 +22693,7 @@
             }
           },
           "307": {
-            "description": "A label in a fallback language exists in the indicated location",
+            "description": "A label in a fallback language exists at the indicated location",
             "headers": {
               "Location": {
                 "description": "The URL to which the requested resource has been moved",
@@ -39673,7 +39677,7 @@
         }
       },
       "DescriptionMovedTemporarily": {
-        "description": "A description in a fallback language exists in the indicated location",
+        "description": "A description in a fallback language exists at the indicated location",
         "headers": {
           "Location": {
             "description": "The URL to which the requested resource has been moved",
@@ -41417,7 +41421,7 @@
         }
       },
       "LabelMovedTemporarily": {
-        "description": "A label in a fallback language exists in the indicated location",
+        "description": "A label in a fallback language exists at the indicated location",
         "headers": {
           "Location": {
             "description": "The URL to which the requested resource has been moved",