CRUD: Improve language fallback OAS docs

* split long summaries across `summary` and `description`

Change-Id: I5e505fed730861e9d02554c43f0a528bbf65bbbe

Author: outdooracorn

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

@@ -11501,7 +11501,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",
@@ -11587,7 +11588,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",
@@ -11632,7 +11633,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",
@@ -12981,7 +12982,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",
@@ -13067,7 +13069,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",
@@ -13112,7 +13114,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",
@@ -21072,7 +21074,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",
@@ -21158,7 +21161,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",
@@ -21203,7 +21206,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",
@@ -22553,7 +22556,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",
@@ -22639,7 +22643,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",
@@ -22684,7 +22688,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",
@@ -39381,7 +39385,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",
@@ -41125,7 +41129,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",