amoeba commented on issue #14752:
URL: https://github.com/apache/arrow/issues/14752#issuecomment-1550157549

   I'd like to see this part of the format docs improved and would be happy to 
submit a PR for review. I read the comments above and in other issues and it 
seems like there's:
   
   1. Still some discussion to be had about avoiding "logical" vs. "physical" 
in favor of "types" and "layouts" and possibly updating the format docs 
comprehensively
   2. Concensus around listing all types (ie everything in 
https://github.com/apache/arrow/blob/505a2e4519ba8d4983da6caa1c56ecae8d063e84/format/Schema.fbs#L407C5-L430)
 in a table with columns for layouts and parameters, where appropriate.
   
   I could start with a PR for (2). Looking at the high level sections in 
https://arrow.apache.org/docs/format/Columnar.html, I think a comprehensive 
table of types would be best right after Terminology and before Physical Memory 
Layout as I think people would generally want to know the types before their 
physical layouts. Does this sound reasonable?


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

Reply via email to