cwsteinbach commented on a change in pull request #3037:
URL: https://github.com/apache/iceberg/pull/3037#discussion_r697066944



##########
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.

Review comment:
       I'm not sure what "finished" and "supported by the community" actually 
means, e.g., which community? what is finished (the spec? all of the reader 
libraries? integrations with all supported engines?)
   
   Please consider replacing instances of "Iceberg format" with "Iceberg format 
specification".
   
   Also, including dates when each format version was "finished" would be nice.




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

Reply via email to