Skip to content

ARROW-13036: [Doc] Mention recommended file extension(s) for Arrow IPC - #10512

Closed
westonpace wants to merge 5 commits into
apache:masterfrom
westonpace:feature/ARROW-13036--doc-mention-recommended-file-extension-s-for-ar
Closed

ARROW-13036: [Doc] Mention recommended file extension(s) for Arrow IPC#10512
westonpace wants to merge 5 commits into
apache:masterfrom
westonpace:feature/ARROW-13036--doc-mention-recommended-file-extension-s-for-ar

Conversation

@westonpace

Copy link
Copy Markdown
Member

See JIRA

@github-actions

Copy link
Copy Markdown

kou
kou approved these changes Jun 11, 2021

@koukou left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

+1

Comment threaddocs/source/format/Columnar.rst Outdated
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
Copy Markdown
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
Copy Markdown
MemberAuthor

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"

Comment threaddocs/source/format/Columnar.rst Outdated
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
Copy Markdown
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
Copy Markdown
MemberAuthor

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 pitrouJune 15, 2021 19:40

@pitroupitrou left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

+1, thank you @westonpace

sjperkins pushed a commit to sjperkins/arrow that referenced this pull request Jun 23, 2021
See JIRA
Closesapache#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 freeto 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

@westonpace@kou@pitrou