rdblue commented on a change in pull request #3425:
URL: https://github.com/apache/iceberg/pull/3425#discussion_r753601975
##########
File path: site/docs/spec.md
##########
@@ -548,6 +548,21 @@ Notes:
1. An alternative, *strict projection*, creates a partition predicate that
will match a file if all of the rows in the file must match the scan predicate.
These projections are used to calculate the residual predicates for each file
in a scan.
2. For example, if `file_a` has rows with `id` between 1 and 10 and a delete
file contains rows with `id` between 1 and 4, a scan for `id = 9` may ignore
the delete file because none of the deletes can match a row that will be
selected.
+#### Snapshot Reference
+
+Snapshot reference allows users to perform tagging and branching within an
Iceberg table. The detailed user experience is described in [Iceberg Tagging
and Branching](../snapshot-tag-branch).
Review comment:
I would avoid linking to user experience from the spec. The spec sets
requirements and should include enough to understand those requirements. But we
don't want to be overly prescriptive or make it seem like there are additional
requirements outside of the spec.
--
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]
