docs: added manage products documentation (#3867)

* docs: added manage products documentation

* lint fixes

* generated oas types

packages/medusa/src/api/routes/admin/products/add-option.ts

@@ -8,7 +8,7 @@ import { EntityManager } from "typeorm"
 /**
  * @oas [post] /admin/products/{id}/options
  * operationId: "PostProductsProductOptions"
- * summary: "Add an Option"
+ * summary: "Add a Product Option"
  * x-authenticated: true
  * description: "Adds a Product Option to a Product"
  * parameters:

packages/medusa/src/api/routes/admin/products/delete-option.ts

@@ -22,7 +22,7 @@ import { ProductService } from "../../../../services"
  *       const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 })
  *       // must be previously logged in or use api token
  *       medusa.admin.products.deleteOption(product_id, option_id)
- *       .then(({ option_id, object, delete, product }) => {
+ *       .then(({ option_id, object, deleted, product }) => {
  *         console.log(product.id);
  *       });
  *   - lang: Shell

packages/medusa/src/api/routes/admin/products/update-variant.ts

@@ -150,8 +150,6 @@ class ProductVariantOptionReq {
 /**
  * @schema AdminPostProductsProductVariantsVariantReq
  * type: object
- * required:
- *   - prices
  * properties:
  *   title:
  *     description: The title to identify the Product Variant by.