ronkorving opened a new issue, #9127: URL: https://github.com/apache/iceberg/issues/9127
### Apache Iceberg version None ### Query engine None ### Please describe the bug 🐞 Looking at the ReadMe in the root of this repository, one would be mistaken for thinking we're living in Table v1 times. **Quote start:** Iceberg is under active development at the Apache Software Foundation. The core Java library that tracks table snapshots and metadata is complete, but still evolving. Current work is focused on adding row-level deletes and upserts, and integration work with new engines like Flink and Hive. The [Iceberg format specification](https://iceberg.apache.org/spec) is being actively updated and is open for comment. Until the specification is complete and released, it carries no compatibility guarantees. The spec is currently evolving as the Java reference implementation changes. [Java API javadocs](https://iceberg.apache.org/javadoc/latest) are available for the main. **Quote end** That last sentence seems incomplete. But more importantly, I think the information provided is, today at least, no longer correct. I've been told there _are_ compatibility guarantees, and what's being worked on today is probably no longer row-level deletes and upserts. I would like to suggest that an update, or perhaps a slimming down of the text, is overdue. -- 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.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