Skip to content

Conversation

@westonpace
Copy link
Member

See JIRA

@github-actions
Copy link

Copy link
Member

@kou kou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1

streaming format) plus memory offsets and sizes for each of the data
blocks in the file. This enables random access any record batch in the
file. See `File.fbs`_ for the precise details of the file footer.
We define a "file format" supporting random access that is built with
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we are at it, can we replace "built with" with something less weird / less confusing? Perhaps "built upon" or "built on top of" or "is an extension of" (or...)?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I went with "is an extension of"

blocks in the file. This enables random access any record batch in the
file. See `File.fbs`_ for the precise details of the file footer.
We define a "file format" supporting random access that is built with
the stream format. We recommend the ".arrow" extension for files. The
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"for such files" or "for IPC files"?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I moved the sentence down to the end and changed it to We recommend the ".arrow" extension for files created with this format.

@westonpace westonpace requested a review from pitrou June 15, 2021 19:40
Copy link
Member

@pitrou pitrou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, thank you @westonpace

@pitrou pitrou closed this in 59c5781 Jun 16, 2021
sjperkins pushed a commit to sjperkins/arrow that referenced this pull request Jun 23, 2021
See JIRA

Closes apache#10512 from westonpace/feature/ARROW-13036--doc-mention-recommended-file-extension-s-for-ar

Authored-by: Weston Pace <weston.pace@gmail.com>
Signed-off-by: Antoine Pitrou <antoine@python.org>
@westonpace westonpace deleted the feature/ARROW-13036--doc-mention-recommended-file-extension-s-for-ar branch January 6, 2022 08:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants