[jira] [Updated] (ARROW-6818) [Doc] Format docs confusing

["ASF GitHub Bot (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/ARROW-6818?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

ASF GitHub Bot updated ARROW-6818:
----------------------------------
    Labels: pull-request-available  (was: )

> [Doc] Format docs confusing
> ---------------------------
>
>                 Key: ARROW-6818
>                 URL: https://issues.apache.org/jira/browse/ARROW-6818
>             Project: Apache Arrow
>          Issue Type: Bug
>          Components: Documentation, Format
>            Reporter: Antoine Pitrou
>            Assignee: Micah Kornfield
>            Priority: Major
>              Labels: pull-request-available
>          Time Spent: 10m
>  Remaining Estimate: 0h
>
> I find there are several issues in the format docs.
> 1) there is a claimed distinction between "logical types" and "physical types", but the "physical types" actually lists logical types such as Map
> 2) the "logical types" document doesn't actually list logical types, it just sends to the flatbuffers file. One shouldn't have to read a flatbuffers file to understand the Arrow format.
> 3) some terminology seems unusual, such as "relative type"
> 4) why is there a link to the Apache Drill docs?



--
This message was sent by Atlassian Jira
(v8.3.4#803005)