[ARROW-1166] Errors in Struct type's example and missing reference in Layout.md

• Type: Bug
• Status: Resolved
• Priority: Trivial
• Resolution: Fixed
• Affects Version/s: 0.4.1
• Fix Version/s: 0.5.0
• Component/s: Documentation
• Labels: documentation easyfix
• Flags: Patch
• External issue URL: https://github.com/apache/arrow/issues/16836
• Assignee: Fang Zheng
• Reporter: Fang Zheng
• Created: 29/Jun/17 16:09
• Updated: 11/Jan/23 07:13
• Resolved: 29/Jun/17 20:01

Description

Hi,
There seem to be several minor issues in Layout.md:

1. In the example for Struct type (https://github.com/apache/arrow/blob/master/format/Layout.md#struct-type), the second array element is "

{null, 2}

" in the text, but in the Arrow representation, the value buffer for field 0 has "bob" in the corresponding slot. Either the text should be changed from "null" to "bob", or the Null count, Null bitmap buffer, and Offsets buffer should be changed to count the second element in field 0 as null.

2. In the same Struct type example, the third element in the Struct array is "null" in text, but the value buffer for field 1 has 3 in the corresponding slot in the Arrow representation. The Null count, Null bitmap buffer, and Value buffer should be changed to count the third element in field 1 as null.

3. In the Dictionary encoding section (https://github.com/apache/arrow/blob/master/format/Layout.md#dictionary-encoding), there is a missing reference to "Message.fbs".