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/BaseFulfillmentProvider.ts

@@ -1,7 +1,7 @@
 /**
  * @schema BaseFulfillmentProvider
  * type: object
- * description: The shipping option's provider.
+ * description: The fulfillment provider's details.
  * x-schemaName: BaseFulfillmentProvider
  * required:
  *   - id
@@ -14,7 +14,7 @@
  *   is_enabled:
  *     type: boolean
  *     title: is_enabled
- *     description: The provider's is enabled.
+ *     description: Whether the provider is enabled.
  * 
 */