chore(oas): [16/n] improve oas schemas (#9272)

- Improve OAS schemas [16/n]
- fixes and improvements to docs-generator tool

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

@@ -3,6 +3,65 @@
  * type: object
  * description: The tax line's tax lines.
  * x-schemaName: BaseOrderLineItemTaxLine
+ * properties:
+ *   item:
+ *     $ref: "#/components/schemas/BaseOrderLineItem"
+ *   item_id:
+ *     type: string
+ *     title: item_id
+ *     description: The ID of the associated line item.
+ *   total:
+ *     type: number
+ *     title: total
+ *     description: The tax line's total including promotions.
+ *   subtotal:
+ *     type: number
+ *     title: subtotal
+ *     description: The tax line's subtotal excluding promotions.
+ *   id:
+ *     type: string
+ *     title: id
+ *     description: The tax line's ID.
+ *   description:
+ *     type: string
+ *     title: description
+ *     description: The tax line's description.
+ *   tax_rate_id:
+ *     type: string
+ *     title: tax_rate_id
+ *     description: The ID of the applied tax rate.
+ *   code:
+ *     type: string
+ *     title: code
+ *     description: The code that the tax rate is identified by.
+ *   rate:
+ *     type: number
+ *     title: rate
+ *     description: The rate to charge.
+ *   provider_id:
+ *     type: string
+ *     title: provider_id
+ *     description: The ID of the tax provider used to calculate the tax line.
+ *   created_at:
+ *     type: string
+ *     format: date-time
+ *     title: created_at
+ *     description: The date the tax line was created.
+ *   updated_at:
+ *     type: string
+ *     format: date-time
+ *     title: updated_at
+ *     description: The date the tax line was updated.
+ * required:
+ *   - item
+ *   - item_id
+ *   - total
+ *   - subtotal
+ *   - id
+ *   - code
+ *   - rate
+ *   - created_at
+ *   - updated_at
  * 
 */