[arrow-adbc] branch main updated: [Docs] Update README (#42)

[li...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

lidavidm pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/arrow-adbc.git


The following commit(s) were added to refs/heads/main by this push:
     new 0fc9b8c  [Docs] Update README (#42)
0fc9b8c is described below

commit 0fc9b8c21e82b3c187a6a9506ac4b73024ac877f
Author: David Li <li...@gmail.com>
AuthorDate: Thu Jul 21 08:17:40 2022 -0400

    [Docs] Update README (#42)
---
 README.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 6a03022..b2aae14 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,22 @@
 
 [![License](http://img.shields.io/:license-Apache%202-blue.svg)](https://github.com/apache/arrow-adbc/blob/master/LICENSE.txt)
 
-EXPERIMENTAL. Please see the [mailing list discussion](https://lists.apache.org/thread/gnz1kz2rj3rb8rh8qz7l0mv8lvzq254w).
+EXPERIMENTAL. Please see the [mailing list discussion][ml-discussion] and the original [proposal][proposal] for context.
+
+ADBC is an API standard for database access libraries ("drivers") in C and Java that uses Arrow for data.
+Instead of writing code for each individual database, applications can build against the ADBC APIs, and link against drivers that implement the standard.
+Additionally, a JDBC/ODBC-style driver manager is provided. This also implements the ADBC APIs, but dynamically loads drivers and dispatches calls to them.
+
+Like JDBC/ODBC, the goal is to provide a generic API for multiple databases, but ADBC is focused on Arrow-based data access for analytics use cases (bulk data retrieval/ingestion), and not the full spectrum of use cases that JDBC/ODBC drivers handle.
+Hence, ADBC is complementary to those existing standards.
+
+Like [Flight SQL][flight-sql], ADBC is an Arrow-based database access API.
+But Flight SQL also specifies the wire format and network transport (Flight RPC), while ADBC lets drivers make their own decisions.
+Together, ADBC and Flight SQL offer a fully Arrow-native solution for clients and database vendors.
+
+[flight-sql]: https://arrow.apache.org/docs/format/FlightSql.html
+[ml-discussion]: https://lists.apache.org/thread/gnz1kz2rj3rb8rh8qz7l0mv8lvzq254w
+[proposal]: https://docs.google.com/document/d/1t7NrC76SyxL_OffATmjzZs2xcj1owdUsIF2WKL_Zw1U/edit#heading=h.r6o6j2navi4c
 
 ## Building