update wording in spec

Author: snazy

open-api/rest-catalog-open-api.yaml

@@ -140,8 +140,13 @@ paths:
       description:
         The `oauth/tokens` endpoint is **DEPRECATED for REMOVAL**. It is _not_ recommended to
         implement this endpoint, unless you are fully aware of the potential security implications.
+
         All clients are encouraged to explicitly set the configuration property `oauth2-server-uri`
         to the correct OAuth endpoint.
+
+        Deprecated since Iceberg (Java) 1.6.0. The endpoint and related types will be removed from
+        this spec in Iceberg (Java) 1.7.0.
+
         See [Security improvements in the Iceberg REST specification](https://github.com/apache/iceberg/issues/10537)
 
 
@@ -2932,8 +2937,8 @@ components:
     OAuthClientCredentialsRequest:
       deprecated: true
       description: 
-        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this spec.
-        
+        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this
+        spec, see description of the endpoint.
 
 
         OAuth2 client credentials request
@@ -2972,7 +2977,8 @@ components:
     OAuthTokenExchangeRequest:
       deprecated: true
       description:
-        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this spec.
+        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this
+        spec, see description of the endpoint.
 
 
         OAuth2 token exchange request
@@ -3007,7 +3013,8 @@ components:
     OAuthTokenRequest:
       deprecated: true
       description:
-        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this spec.
+        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this
+        spec, see description of the endpoint.
       anyOf:
         - $ref: '#/components/schemas/OAuthClientCredentialsRequest'
         - $ref: '#/components/schemas/OAuthTokenExchangeRequest'
@@ -3164,7 +3171,8 @@ components:
     OAuthError:
       deprecated: true
       description:
-        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this spec.
+        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this
+        spec, see description of the endpoint.
       type: object
       required:
         - error
@@ -3186,7 +3194,8 @@ components:
     OAuthTokenResponse:
       deprecated: true
       description:
-        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this spec.
+        The `oauth/tokens` endpoint and related schemas are **DEPRECATED for REMOVAL** from this
+        spec, see description of the endpoint.
       type: object
       required:
         - access_token