adutra commented on code in PR #1890: URL: https://github.com/apache/polaris/pull/1890#discussion_r2152478790
########## site/content/in-dev/unreleased/evolution.md: ########## @@ -27,19 +27,19 @@ This page discusses what can be expected from Apache Polaris as the project evol ## Using Polaris as a Catalog Polaris is primarily intended to be used as a Catalog of Tables and Views. As such, -it implements the [Iceberg REST API, Generic Tables API](../polaris-catalog-service/), -and [Polaris Management API](../polaris-management-service/). +it implements the Iceberg REST Catalog API and its own REST APIs Review Comment: ```suggestion it implements the Iceberg REST Catalog API and its own REST APIs. ``` ########## site/content/in-dev/unreleased/evolution.md: ########## @@ -27,19 +27,19 @@ This page discusses what can be expected from Apache Polaris as the project evol ## Using Polaris as a Catalog Polaris is primarily intended to be used as a Catalog of Tables and Views. As such, -it implements the [Iceberg REST API, Generic Tables API](../polaris-catalog-service/), -and [Polaris Management API](../polaris-management-service/). +it implements the Iceberg REST Catalog API and its own REST APIs -Revisions of the Iceberg REST API are controlled by the [Apache Iceberg](https://iceberg.apache.org/) +Revisions of the Iceberg REST Catalog API are controlled by the [Apache Iceberg](https://iceberg.apache.org/) community. Polaris attempts to accurately implement this specification. Nonetheless, optional REST Catalog features may or may not be supported immediately. In general, there is no guarantee that Polaris releases always implement the latest version of the Iceberg REST Catalog API. -Any API under Polaris control (e.g. the Management API) is maintained as a versioned REST -API. New releases of Polaris may include changes to the current version of the API. When -that happens those changes are intended to be compatible with prior versions of Polaris -clients. Certain endpoints and parameters may be deprecated. +Any API under Polaris control that is not in an "experimental" or "beta" state +(e.g. the Management API) is maintained as a versioned REST API. New releases of Polaris Review Comment: ```suggestion (e.g. the Management API) is maintained as a versioned REST API. New releases of Polaris ``` -- 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...@polaris.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
