Better error examples

Author: nickevansuk

EditorsDraft/edit.html

@@ -1162,15 +1162,16 @@
 
 If there are any issues with the `orderedItem`s provided in the `OrderQuote`, the <a>Booking System</a> MUST respond with a `409 Conflict` response, with `error` details provided against each offending `OrderItem`. Note that `totalPaymentDue` and `totalTaxSpecification` MUST be calculated excluding any `OrderItem`s that include `error`s.
 
-<pre class="example" title="Order Creation: OrderQuote example failure response" data-transform="dataExampleOrderQuoteCreationErrorResponse">
+<pre class="example" title="Order Creation: OrderQuote example OrderItem error response" data-transform="dataExampleOrderQuoteCreationOrderItemErrorResponse">
 </pre>
 
 If there are issues with other properties of the `OrderQuote` outside of `orderedItem`, the <a>Booking System</a> MUST respond with a JSON-LD response which includes only the appropriate `OpenBookingError` and the appropriate status code.
 
-<pre class="example" title="Order Creation: OrderQuote example failure response" data-transform="dataExampleOrderQuoteCreationGenericErrorResponse">
+<pre class="example" title="Order Creation: OrderQuote example failure response" data-transform="dataExampleOrderQuoteCreationErrorResponse">
 </pre>
 
 
+
 #### `Order`
 
 A PUT request to the Order Creation endpoint of the <a>Booking System</a> with an object of type `Order` will create the `Order` and complete the booking from the point of the view of the <a>Booking System</a>.
@@ -1722,8 +1723,8 @@
 5XX status code specified in the model.
 
 All error responses from this API MUST be returned in a JSON-LD format using a
-content type of `application/vnd.openactive+json` and include at least one
-`OpenBookingError` object.
+content type of `application/vnd.openactive+json`, and optionally any version
+parameters, and include at least one `OpenBookingError` object.
 
 <pre class="example" title="Error response format">
 {

EditorsDraft/examples.js

@@ -31,7 +31,7 @@ function dataExampleOrderQuoteCreationResponse(utils, content) {
   });
 }
 
-function dataExampleOrderQuoteCreationErrorResponse(utils, content) {
+function dataExampleOrderQuoteCreationOrderItemErrorResponse(utils, content) {
   return generateResponse("409 Conflict", null, OPERATIONS_MEDIA_TYPE, {
     "@context": CONTEXT,
     "type": "OrderQuote",
@@ -45,7 +45,7 @@ function dataExampleOrderQuoteCreationErrorResponse(utils, content) {
   });
 }
 
-function dataExampleOrderQuoteCreationGenericErrorResponse(utils, content) {
+function dataExampleOrderQuoteCreationErrorResponse(utils, content) {
   return generateResponse("400 Bad Request", null, OPERATIONS_MEDIA_TYPE, {
     "@context": CONTEXT,
     "type": "IncompleteCustomerDetailsError",