You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@arrow.apache.org by tu...@apache.org on 2023/06/30 11:15:26 UTC
[arrow-rs] branch master updated: Docs: Add clearer API doc links (#4461)
This is an automated email from the ASF dual-hosted git repository.
tustvold pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/arrow-rs.git
The following commit(s) were added to refs/heads/master by this push:
new 666764666 Docs: Add clearer API doc links (#4461)
666764666 is described below
commit 6667646660fb0f3248b3cb02e77d89f1ac4f3cf2
Author: Andrew Lamb <an...@nerdnetworks.org>
AuthorDate: Fri Jun 30 07:15:21 2023 -0400
Docs: Add clearer API doc links (#4461)
* Docs: Add clearer API doc links
* prettier
---
README.md | 16 ++++++++--------
arrow-flight/README.md | 4 ++++
arrow/README.md | 4 +++-
parquet/README.md | 4 +++-
4 files changed, 18 insertions(+), 10 deletions(-)
diff --git a/README.md b/README.md
index 53220620a..c3108917e 100644
--- a/README.md
+++ b/README.md
@@ -25,14 +25,14 @@ Welcome to the implementation of Arrow, the popular in-memory columnar format, i
This repo contains the following main components:
-| Crate | Description | Documentation |
-| ------------ | ------------------------------------------------------------------------- | ------------------------------ |
-| arrow | Core functionality (memory layout, arrays, low level computations) | [(README)][arrow-readme] |
-| parquet | Support for Parquet columnar file format | [(README)][parquet-readme] |
-| arrow-flight | Support for Arrow-Flight IPC protocol | [(README)][flight-readme] |
-| object-store | Support for object store interactions (aws, azure, gcp, local, in-memory) | [(README)][objectstore-readme] |
-
-See the list of all crates in this repo and their rustdocs [here](https://arrow.apache.org/rust).
+| Crate | Description | Latest API Docs | README |
+| ------------ | ------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------ |
+| arrow | Core functionality (memory layout, arrays, low level computations) | [docs.rs](https://docs.rs/arrow/latest) | [(README)][arrow-readme] |
+| parquet | Support for Parquet columnar file format | [docs.rs](https://docs.rs/parquet/latest) | [(README)][parquet-readme] |
+| arrow-flight | Support for Arrow-Flight IPC protocol | [docs.rs](https://docs.rs/arrow-flight/latest) | [(README)][flight-readme] |
+| object-store | Support for object store interactions (aws, azure, gcp, local, in-memory) | [docs.rs](https://docs.rs/object_store/latest) | [(README)][objectstore-readme] |
+
+The current development version the API documentation in this repo can be found [here](https://arrow.apache.org/rust).
There are two related crates in a different repository
diff --git a/arrow-flight/README.md b/arrow-flight/README.md
index d4fddba70..9194b209f 100644
--- a/arrow-flight/README.md
+++ b/arrow-flight/README.md
@@ -21,6 +21,10 @@
[![Crates.io](https://img.shields.io/crates/v/arrow-flight.svg)](https://crates.io/crates/arrow-flight)
+See the [API documentation](https://docs.rs/arrow_flight/latest) for examples and the full API.
+
+The API documentation for most recent, unreleased code is available [here](https://arrow.apache.org/rust/arrow_flight/index.html).
+
## Usage
Add this to your Cargo.toml:
diff --git a/arrow/README.md b/arrow/README.md
index adf32ff61..fb2119e3b 100644
--- a/arrow/README.md
+++ b/arrow/README.md
@@ -24,9 +24,11 @@
This crate contains the official Native Rust implementation of [Apache Arrow][arrow] in memory format, governed by the Apache Software Foundation.
-The [crate documentation](https://arrow.apache.org/rust/arrow/index.html) contains examples and full API.
+The [API documentation](https://docs.rs/arrow/latest) contains examples and full API.
There are several [examples](https://github.com/apache/arrow-rs/tree/master/arrow/examples) to start from as well.
+The API documentation for most recent, unreleased code is available [here](https://arrow.apache.org/rust/arrow/index.html).
+
## Rust Version Compatibility
This crate is tested with the latest stable version of Rust. We do not currently test against other, older versions.
diff --git a/parquet/README.md b/parquet/README.md
index 19f34fd87..86c7ee2c3 100644
--- a/parquet/README.md
+++ b/parquet/README.md
@@ -24,7 +24,9 @@
This crate contains the official Native Rust implementation of [Apache Parquet](https://parquet.apache.org/), which is part of the [Apache Arrow](https://arrow.apache.org/) project.
-See [crate documentation](https://arrow.apache.org/rust/parquet/index.html) for examples and the full API.
+See the [API documentation](https://docs.rs/parquet/latest) for examples and the full API.
+
+The API documentation for most recent, unreleased code is available [here](https://arrow.apache.org/rust/parquet/index.html).
## Rust Version Compatibility