ebyhr commented on code in PR #15277:
URL: https://github.com/apache/iceberg/pull/15277#discussion_r2784880972


##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -27,7 +27,7 @@ info:
   version: 0.0.1
   description:
     Defines the specification for the first version of the REST Catalog API.
-    Implementations should ideally support both Iceberg table specs v1 and v2, 
with priority given to v2.
+    Implementations should ideally support Iceberg table specs v1, v2 and v3, 
with priority given to v2.

Review Comment:
   Do we really need to list the spec versions here? What about rephrasing it 
to something like, "Implementations should ideally support all Iceberg table 
spec versions"?
   
   We already mention the supported versions here: 
   
https://github.com/apache/iceberg/blob/d95d9f0ad8baacd1a61331be9c5e09587a89f1f2/open-api/rest-catalog-open-api.yaml#L2659-L2662
   
   The motivation recommending v2 instead of v3 is also unclear to me.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to