Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/types/channel/ChannelRoleEnum.raml

@@ -3,7 +3,7 @@
 displayName: ChannelRoleEnum
 type: string
 description: |
-  Describes the purpose and type of the Channel. A Channel can have one or more roles.
+  Describes how a Channel is used. A Channel can have one or more roles.
 enum:
   - InventorySupply
   - ProductDistribution
@@ -17,8 +17,11 @@ enum:
     Channel can be used to expose Products to a specific distribution Channel.
     The Channel can be used by a Cart to [select](/api/pricing-and-discounts-overview#line-item-price-selection) a Product Price.
   OrderExport: |
-    Channel can be used to track order export activities.
+    Channel identifies a synchronization destination used when storing export information in [SyncInfo](ctp:api:type:SyncInfo).
+    You can reference it with [Update SyncInfo](ctp:api:type:OrderUpdateSyncInfoAction) on Orders and Order Edits.
   OrderImport: |
-    Channel can be used to track order import activities.
+    Channel identifies a synchronization destination used when storing import information in [SyncInfo](ctp:api:type:SyncInfo).
+    You can reference it with [Update SyncInfo](ctp:api:type:OrderUpdateSyncInfoAction) on Orders and Order Edits.
   Primary: |
-    This role can be combined with the other roles (for example, with `InventorySupply`). If used, the Channel is considered as the primary or main channel among Channels of the same type.
+    Marks the Channel as the default or preferred Channel among Channels with the same role.
+    It can be combined with another role, for example `InventorySupply`.

api-specs/api/types/project/ExternalOAuth.raml

@@ -4,9 +4,13 @@ type: object
 displayName: ExternalOAuth
 example: !include ../../examples/Project/ExternalOAuth.json
 description: |
-  Represents a RFC 7662 compliant [OAuth 2.0 Token Introspection](https://datatracker.ietf.org/doc/html/rfc7662) endpoint. For more information, see [Requesting an access token using an external OAuth 2.0 server](/api/authorization#request-an-access-token-using-an-external-oauth-server).
+  Represents an RFC 7662-compliant [OAuth 2.0 Token Introspection](https://datatracker.ietf.org/doc/html/rfc7662) endpoint.
+  For more information, see [Requesting an access token using an external OAuth 2.0 server](/api/authorization#request-an-access-token-using-an-external-oauth-server).
 
-  You can only configure **one** external OAuth 2.0 endpoint per Project. To authenticate using multiple external services (such as social network logins), use a middle layer authentication service.
+  You can only configure **one** external OAuth 2.0 endpoint per Project.
+  To authenticate using multiple external services (such as social network logins), use a middle layer authentication service that delegates to those services and exposes a single RFC 7662-compliant OAuth 2.0 Token Introspection endpoint to the commercetools APIs.
+  This middle layer is a custom service that you build and host.
+  It receives the token introspection request from the APIs, routes the token validation to the appropriate external service, and returns the introspection response in the expected format.
 properties:
   url:
     type: string

api-specs/api/types/tax-category/TaxRate.raml

@@ -38,6 +38,7 @@ properties:
     type: string
     description: |
       State within the country, such as Texas in the United States.
+      The value is case-sensitive and must use the same casing as the `state` value in the Cart `shippingAddress`.
   subRates?:
     type: SubRate[]
     description: |

api-specs/api/types/tax-category/TaxRateDraft.raml

@@ -26,6 +26,7 @@ properties:
     type: string
     description: |
       State within the country, such as Texas in the United States.
+      The value is case-sensitive and must use the same casing as the `state` value in the Cart `shippingAddress`.
   subRates?:
     type: SubRate[]
     description: |