chore(docs): Updated API Reference (v2) (#9437)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>

www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml

@@ -1,5 +1,5 @@
 type: object
-description: The updated's details.
+description: The shipping option rule's details.
 x-schemaName: AdminShippingOptionRule
 required:
   - id
@@ -14,42 +14,46 @@ properties:
   id:
     type: string
     title: id
-    description: The updated's ID.
+    description: The shipping option rule's ID.
   attribute:
     type: string
     title: attribute
-    description: The updated's attribute.
+    description: The shipping option rule's attribute.
+    example: is_return
   operator:
     type: string
     title: operator
-    description: The updated's operator.
+    description: The shipping option rule's operator.
+    example: eq
   value:
     oneOf:
       - type: string
         title: value
-        description: The updated's value.
+        description: The rule's value.
+        example: '"true"'
       - type: array
-        description: The updated's value.
+        description: The rule's values.
         items:
           type: string
           title: value
-          description: The value's details.
+          description: A rule's value
+          example: '"true"'
   shipping_option_id:
     type: string
     title: shipping_option_id
-    description: The updated's shipping option id.
+    description: The ID of the shipping option this rule is for.
   created_at:
     type: string
     format: date-time
     title: created_at
-    description: The updated's created at.
+    description: The date the shipping option rule was created.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The updated's updated at.
+    description: The date the shipping option rule was updated.
   deleted_at:
     type: string
     format: date-time
     title: deleted_at
-    description: The updated's deleted at.
+    description: The date the shipping option rule was deleted.