rdblue commented on a change in pull request #3037:
URL: https://github.com/apache/iceberg/pull/3037#discussion_r705794401
##########
File path: site/docs/spec.md
##########
@@ -19,15 +19,23 @@
This is a specification for the Iceberg table format that is designed to
manage a large, slow-changing collection of files in a distributed file system
or key-value store as a table.
+## Format Versioning
+
+Versions 1 and 2 of the Iceberg format are finished and supported by the
community.
+
+The format version number is incremented when new features are added that will
break forward-compatibility---that is, when older readers would not read newer
table features correctly. Tables may continue to be written with an older
version of the spec to ensure compatibility by not using features that are not
yet implemented by processing engines.
Review comment:
This statement applies to the spec and explains when we will increment
the version number. I think it is reasonable to add that v2 is
backward-compatible with v1 (v1 files are all valid v2 files).
I agree with Dan that we don't necessarily guarantee that moving forward.
Also, we don't want to comment on any specific library that supports Iceberg,
reference implementation included.
--
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
