jackye1995 commented on code in PR #9940:
URL: https://github.com/apache/iceberg/pull/9940#discussion_r1670758743
##########
open-api/rest-catalog-open-api.yaml:
##########
@@ -28,6 +28,10 @@ info:
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.
+
+ This API uses capability tags to describe optional functionality.
+ In order to support a particular capability, a server is required to
implement all endpoints grouped under a particular tag.
Review Comment:
> Introducing table-read / table-management / table-write / table-delete
seems to be rather going in a finer grained direction and I don't think we want
to end up having a 1:1 mapping between a single endpoint and a single
capability.
We discussed this in the last sync meeting. I am good with having just a
tables capability + documentation. I mainly raised it after seeing ones like
`table-register` recommended in the PR, but seems like that is no longer valid.
--
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: issues-unsubscr...@iceberg.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For additional commands, e-mail: issues-h...@iceberg.apache.org
