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

["Antoine Pitrou (Jira)" <ji...@apache.org>]

Antoine Pitrou created ARROW-6818:
-------------------------------------

             Summary: [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


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)