chore(oas): [11/n] improve oas schemas (#9188)

Improve OAS schemas [11/n]

www/utils/generated/oas-output/schemas/AdminReservation.ts

@@ -20,11 +20,11 @@
  *   line_item_id:
  *     type: string
  *     title: line_item_id
- *     description: The reservation's line item id.
+ *     description: The ID of the line item this reservation is for.
  *   location_id:
  *     type: string
  *     title: location_id
- *     description: The reservation's location id.
+ *     description: The ID of the location the quantity is reserved from.
  *   quantity:
  *     type: number
  *     title: quantity
@@ -32,7 +32,7 @@
  *   external_id:
  *     type: string
  *     title: external_id
- *     description: The reservation's external id.
+ *     description: An ID in an external system
  *   description:
  *     type: string
  *     title: description
@@ -40,32 +40,32 @@
  *   inventory_item_id:
  *     type: string
  *     title: inventory_item_id
- *     description: The reservation's inventory item id.
+ *     description: The ID of the inventory item this reservation is associated with.
  *   inventory_item:
  *     type: object
- *     description: The reservation's inventory item.
+ *     description: The associated inventory item.
  *   metadata:
  *     type: object
- *     description: The reservation's metadata.
+ *     description: The reservation's metadata, can hold custom key-value pairs.
  *   created_by:
  *     type: string
  *     title: created_by
- *     description: The reservation's created by.
+ *     description: The ID of the user that created this reservation.
  *   deleted_at:
  *     type: string
  *     format: date-time
  *     title: deleted_at
- *     description: The reservation's deleted at.
+ *     description: The date this reservation was deleted.
  *   created_at:
  *     type: string
  *     format: date-time
  *     title: created_at
- *     description: The reservation's created at.
+ *     description: The date this reservation was created.
  *   updated_at:
  *     type: string
  *     format: date-time
  *     title: updated_at
- *     description: The reservation's updated at.
+ *     description: The date this reservation was updated.
  * 
 */