douenergy opened a new pull request, #507:
URL: https://github.com/apache/parquet-format/pull/507

   ### Rationale for this change
   
   When first reading the Variant encoding spec, it can be unclear that each 
Variant value begins with a single `value_metadata` byte composed of 
`value_header` and `basic_type`. This can be confusing, especially since 
“metadata” is also used to refer to the dictionary metadata structure.
   
   The spec already uses the term `value_metadata` in prose, so labeling it 
clearly in the layout diagram helps reinforce understanding and reduce 
ambiguity.
   
   ### What changes are included in this PR?
   
   - Added a clarifying comment (`<-- value_metadata`) to the value layout 
diagram to explicitly indicate that the first byte is `value_metadata`.
   
   ### Do these changes have PoC implementations?
   
   N/A — documentation-only change, no impact on implementations.


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