adam-christian-software commented on code in PR #3000:
URL: https://github.com/apache/polaris/pull/3000#discussion_r2504617133


##########
site/content/in-dev/unreleased/generic-table.md:
##########
@@ -157,13 +158,10 @@ curl -X DELETE 
http://localhost:8181/api/catalog/polaris/v1/delta_catalog/namesp
 
 For the complete and up-to-date API specification, see the [Catalog API 
Spec](https://editor-next.swagger.io/?url=https://raw.githubusercontent.com/apache/polaris/refs/heads/main/spec/generated/bundled-polaris-catalog-service.yaml).
 
-## Limitations
+## Known Limitations
 
-Current limitations of Generic Table support:
-1) Limited spec information. Currently, there is no spec for information like 
Schema, Partition etc.
-2) No commit coordination or update capability provided at the catalog service 
level.
-
-Therefore, the catalog itself is unaware of anything about the underlying 
table except some of the loosely defined metadata.
-It is the responsibility of the engine (and plugins used by the engine) to 
determine exactly how loading or committing data

Review Comment:
   I agree that it is important for people to understand the contract between 
the client & the server. I believe that this might be helpful to put into the 
Generic Tables information rather than inside of the limitations. But, let me 
see if I can make it more concise.
   
   I workshopped it. Let me know what you think.



-- 
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]

Reply via email to