[GitHub] [arrow-site] nealrichardson commented on a change in pull request #63: ARROW-9335: [Website] Update website for 1.0
nealrichardson commented on a change in pull request #63: URL: https://github.com/apache/arrow-site/pull/63#discussion_r460204935 ## File path: faq.md ## @@ -24,32 +24,160 @@ limitations under the License. # Frequently Asked Questions +## General + +### What *is* Arrow? + +Arrow is an open standard for how to represent columnar data in memory, along +with libraries in many languages that implement that standard. The Arrow format +allows different programs and runtimes, perhaps written in different languages, +to share data efficiently using a set of rich data types (included nested +and user-defined data types). The Arrow libraries make it easy to write such +programs, by sparing the programmer from implementing low-level details of the +Arrow format. + +Arrow additionally defines a streaming format and a file format for +inter-process communication (IPC), based on the in-memory format. It also +defines a generic client-server RPC mechanism (Flight RPC), based on the +IPC format, and implemented on top of the gRPC framework. + +### Why create a new standard? + + + +## Project status + ### How stable is the Arrow format? Is it safe to use in my application? + + +The Arrow *in-memory format* is considered stable, and we intend to make only +backwards-compatible changes, such as additional data types. It is used by +many applications already, and you can trust that compatibility will not be +broken. + +The Arrow *file format* (based on the Arrow IPC mechanism) is not recommended +for long-term disk persistence of data; that said, it is perfectly acceptable +to write Arrow memory to disk for purposes of memory mapping and caching. + +We encourage people to start building Arrow-based in-memory computing +applications now, and choose a suitable file format for disk storage +if necessary. The Arrow libraries include adapters for several file formats, +including Parquet, ORC, CSV, and JSON. + +### How stable are the Arrow libraries? + +Some implementations of Arrow are more complete and more stable than others. +We refer you to the [implementation matrix](https://github.com/apache/arrow/blob/master/docs/source/status.rst). Review comment: I've done this. This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org
[GitHub] [arrow-site] nealrichardson commented on a change in pull request #63: ARROW-9335: [Website] Update website for 1.0
nealrichardson commented on a change in pull request #63:
URL: https://github.com/apache/arrow-site/pull/63#discussion_r458325181
##
File path: .github/workflows/deploy.yml
##
@@ -45,7 +45,7 @@ jobs:
- name: Configure for GitHub Pages on master
run: |
owner=$(jq --raw-output .repository.owner.login ${GITHUB_EVENT_PATH})
- repository=$(jq .repository.name ${GITHUB_EVENT_PATH})
+ repository=$(jq --raw-output .repository.name ${GITHUB_EVENT_PATH})
Review comment:
I'm not sure that `github.repository.name` is a thing.
`github.repository` is a string, per
https://docs.github.com/en/actions/reference/context-and-expression-syntax-for-github-actions#github-context
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
[GitHub] [arrow-site] nealrichardson commented on a change in pull request #63: ARROW-9335: [Website] Update website for 1.0
nealrichardson commented on a change in pull request #63:
URL: https://github.com/apache/arrow-site/pull/63#discussion_r457663485
##
File path: .github/workflows/deploy.yml
##
@@ -45,7 +45,7 @@ jobs:
- name: Configure for GitHub Pages on master
run: |
owner=$(jq --raw-output .repository.owner.login ${GITHUB_EVENT_PATH})
- repository=$(jq .repository.name ${GITHUB_EVENT_PATH})
+ repository=$(jq --raw-output .repository.name ${GITHUB_EVENT_PATH})
Review comment:
I did something like that before but Kou also changed it and I got a
merge conflict, must've just kept his version 路
https://github.com/apache/arrow-site/pull/63/commits/270c3225050c575126d8de23e78f028c51f19bf9
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
[GitHub] [arrow-site] nealrichardson commented on a change in pull request #63: ARROW-9335: [Website] Update website for 1.0
nealrichardson commented on a change in pull request #63: URL: https://github.com/apache/arrow-site/pull/63#discussion_r456533214 ## File path: _posts/2020-07-16-1.0.0-release.md ## @@ -0,0 +1,90 @@ +--- +layout: post +title: "Apache Arrow 1.0.0 Release" +date: "2020-07-16 00:00:00 -0600" +author: pmc +categories: [release] +--- + + +The Apache Arrow team is pleased to announce the 1.0.0 release. This covers +over 2 months of development work and includes [**XX resolved issues**][1] +from [**XX distinct contributors**][2]. See the Install Page to learn how to +get the libraries for your platform. + +The release notes below are not exhaustive and only expose selected highlights +of the release. Many other bugfixes and improvements have been made: we refer +you to the [complete changelog][3]. + +## 1.0 Format Release + +The 1.0 major release indicates that the Arrow columnar format is declared +stable, with [forward and backward compatibility guarantees][5]. + +Integration testing, link to implementation matrix + +Format changes: unions, unsigned int dictionary indices, decimal bit width, feature enum. + +## Community + +Since the last release, we have added two new committers: + +* Liya Fan +* Ji Liu + +Thank you for all your contributions! + + + +## Arrow Flight RPC notes + +## C++ notes + +## C# notes + +## Go notes + +## Java notes + Review comment: > For more on what’s in the 1.0.0 R package, see the [Java changelog][5]. If there is a Java changelog, please add a link to it below and give it a higher number here (5 is already taken). Also change where this says "R package". If you do this as a "suggestion" comment, I can just merge it here. This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org
