amogh-jahagirdar commented on code in PR #16025:
URL: https://github.com/apache/iceberg/pull/16025#discussion_r3156401323


##########
format/spec.md:
##########
@@ -885,13 +984,14 @@ Tags are labels for individual snapshots. Branches are 
mutable named references
 
 The snapshot reference object records all the information of a reference 
including snapshot ID, reference type and [Snapshot Retention 
Policy](#snapshot-retention-policy).
 
-| v1         | v2         | Field name                   | Type      | 
Description |
-| ---------- | ---------- | ---------------------------- | --------- | 
----------- |
-| _required_ | _required_ | **`snapshot-id`**            | `long`    | A 
reference's snapshot ID. The tagged snapshot or latest snapshot of a branch. |
-| _required_ | _required_ | **`type`**                   | `string`  | Type of 
the reference, `tag` or `branch` |
-| _optional_ | _optional_ | **`min-snapshots-to-keep`**  | `int`     | For 
`branch` type only, a positive number for the minimum number of snapshots to 
keep in a branch while expiring snapshots. Defaults to table property 
`history.expire.min-snapshots-to-keep`. |
-| _optional_ | _optional_ | **`max-snapshot-age-ms`**    | `long`    | For 
`branch` type only, a positive number for the max age of snapshots to keep when 
expiring, including the latest snapshot. Defaults to table property 
`history.expire.max-snapshot-age-ms`. |
-| _optional_ | _optional_ | **`max-ref-age-ms`**         | `long`    | For 
snapshot references except the `main` branch, a positive number for the max age 
of the snapshot reference to keep while expiring snapshots. Defaults to table 
property `history.expire.max-ref-age-ms`. The `main` branch never expires. |
+=== "v1 - v3"

Review Comment:
   If people like the two tabbed approach then we should get 
https://github.com/apache/iceberg/pull/14656 in first, that'll make this diff 
easier to review 



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