[ARROW-6818] [Doc] Format docs confusing

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.0.0
• Component/s: Documentation, Format
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/23150
• Assignee: Martin Blostein
• Reporter: Antoine Pitrou
• Created: 08/Oct/19 17:36
• Updated: 11/Jan/23 07:49
• Resolved: 05/Mar/21 01:34

Description

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?

Issue Links

• links to: GitHub Pull Request #9442