FYI: I pushed another update: * Removed java code from SemVer - the main rationale for this is that the API surface at this stage of the project is still pretty volatile and following semver will probably mean that every release is a new major. Please let me know if you'd prefer a different approach.
* Removed links to Open API for REST API - this is because OpenAPI definitions currently conflate the stable Iceberg REST Catalog API and the "beta" Generic Tables API. Linking to both of them from the "evolution" doc may be perceived by users as a declaration that the Generic Tables API is as stable as the Catalog API. Please have another look. Thanks, Dmitri. On Mon, Jun 16, 2025 at 12:50 PM Dmitri Bourlatchkov <di...@apache.org> wrote: > FYI: Another revision of this page has been pushed to GH for review. > > On Fri, Jun 13, 2025 at 9:45 PM Dmitri Bourlatchkov <di...@apache.org> > wrote: > >> Hi All, >> >> I made a few edits to the PR with feedback in mind, but not always >> strictly following suggestions. >> >> Please review again and comment if you disagree with my edits. >> >> Note: I added a new section for "Managing Polaris Database". I meant to >> have it in this PR right away, but simply forgot to write in the first >> revision. >> >> Note: I added SemVer. I do believe it to be useful, but I also think that >> the project's pace at this time combined with SemVer guidelines is very >> likely to require incrementing the major version number for at least a few >> initial releases. I am personally fine with that. I am mentioning it here >> for awareness in case other people have different opinions. >> >> Thanks, >> Dmitri. >> >> On Fri, Jun 13, 2025 at 3:09 PM Dmitri Bourlatchkov <di...@apache.org> >> wrote: >> >>> Hi All, >>> >>> As discussed in the community sync yesterday, I raised PR [1890] to >>> inform users about what to expect as Polaris evolves. >>> >>> Please review and comment in the PR. If you have a bigger concern, it >>> might be best to reply to this thread instead. >>> >>> I will send a separate email notice if / when the PR is approved for >>> extra awareness. >>> >>> [1890] https://github.com/apache/polaris/pull/1890 >>> >>> Thanks, >>> Dmitri. >>> >>
