This is an automated email from the ASF dual-hosted git repository. erickguan pushed a commit to branch doc-binding in repository https://gitbox.apache.org/repos/asf/opendal.git
commit 2ae31f877fdfad16cf739b7a25b39d21fdf73620 Author: Erick Guan <[email protected]> AuthorDate: Fri Jul 10 22:11:27 2026 +0800 Use plain prose and active tone for bindings --- bindings/README.md | 8 ++++++-- bindings/c/README.md | 6 ++++-- bindings/cpp/README.md | 6 ++++-- bindings/dart/README.md | 6 ++++-- bindings/dotnet/README.md | 5 ++++- bindings/go/README.md | 5 ++++- bindings/haskell/README.md | 5 ++++- bindings/java/README.md | 5 ++++- bindings/lua/README.md | 6 ++++-- bindings/nodejs/README.md | 5 ++++- bindings/python/README.md | 5 ++++- bindings/ruby/README.md | 5 ++++- bindings/swift/README.md | 6 ++++-- 13 files changed, 54 insertions(+), 19 deletions(-) diff --git a/bindings/README.md b/bindings/README.md index f92bd422e..dc448ce19 100644 --- a/bindings/README.md +++ b/bindings/README.md @@ -27,9 +27,13 @@ This folder contains the bindings for OpenDAL. Currently, we support the followi ## Versioning -**Important**: Each binding has its own independent version number, which may differ from the Rust core version. This allows bindings to be released and versioned independently based on their own release cycles and compatibility requirements. +We release each binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). This allows +bindings to follow their own release cycles and compatibility requirements. -For example, while the Rust core might be at version `0.55.0`, a binding might be at version `0.47.0` or `0.49.2`. When checking for updates or compatibility, always refer to the specific binding's version rather than the core version. +For example, while the `opendal` crate might be at version `0.55.0`, a binding +might be at version `0.47.0` or `0.49.2`. For updates and compatibility, use +the specific binding version instead of the `opendal` crate version. ## Getting Started diff --git a/bindings/c/README.md b/bindings/c/README.md index 4fda46e66..fdcda230b 100644 --- a/bindings/c/README.md +++ b/bindings/c/README.md @@ -5,8 +5,10 @@ A C binding for OpenDAL, providing blocking access to S3, GCS, Azure Blob, the local filesystem, and 50+ more storage backends through a single C API. -> **Note**: This binding has its own independent version number, which may differ -> from the Rust core version. +We release the OpenDAL C binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the C binding version instead of the `opendal` crate +version. **User guide**: https://opendal.apache.org/docs/bindings/c diff --git a/bindings/cpp/README.md b/bindings/cpp/README.md index 4007a61a0..a7f76bb21 100644 --- a/bindings/cpp/README.md +++ b/bindings/cpp/README.md @@ -8,8 +8,10 @@ local filesystem, and 50+ more services through one API. > **Note**: This binding is experimental/WIP. Only Clang and AppleClang are > currently supported. The API may change without notice. -> **Note**: This binding has its own independent version number. When checking -> compatibility, refer to this binding's version, not the Rust core version. +We release the OpenDAL C++ binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the C++ binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/dart/README.md b/bindings/dart/README.md index c5cdd14ad..8a83ae3b6 100644 --- a/bindings/dart/README.md +++ b/bindings/dart/README.md @@ -4,8 +4,10 @@ A Dart binding for [Apache OpenDAL](https://opendal.apache.org/): access S3, GCS, Azure Blob, the local filesystem, and 50+ more services through one API. Built on the Rust core via [flutter_rust_bridge](https://github.com/fzyzcjy/flutter_rust_bridge). -> **Note**: This binding has its own independent version number, which may -> differ from the Rust core version. +We release the OpenDAL Dart binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Dart binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/dotnet/README.md b/bindings/dotnet/README.md index 73b20c47c..f63a7a0e6 100644 --- a/bindings/dotnet/README.md +++ b/bindings/dotnet/README.md @@ -5,7 +5,10 @@ This package provides a native .NET binding for **Apache OpenDAL™**, a data access layer that allows you to access various storage services in a unified way. -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to this binding's version rather than the core version. +We release the OpenDAL .NET binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the .NET binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/go/README.md b/bindings/go/README.md index e35b33745..00e8c89e9 100644 --- a/bindings/go/README.md +++ b/bindings/go/README.md @@ -5,7 +5,10 @@ opendal-go is a **Native** Go binding for Apache OpenDAL. It is built on top of `opendal-c` without CGO enabled, using [purego](https://github.com/ebitengine/purego) and libffi. -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to this binding's version rather than the core version. +We release the OpenDAL Go binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Go binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/haskell/README.md b/bindings/haskell/README.md index 58a6ab93d..6900561b5 100644 --- a/bindings/haskell/README.md +++ b/bindings/haskell/README.md @@ -2,7 +2,10 @@ [](https://opendal.apache.org/docs/bindings/haskell) -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. +We release the OpenDAL Haskell binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Haskell binding version instead of the `opendal` +crate version. Access S3, GCS, Azure Blob, the local filesystem, and 50+ more services from Haskell through a single, consistent API backed by the OpenDAL Rust core. diff --git a/bindings/java/README.md b/bindings/java/README.md index 1aedab665..856554bb8 100644 --- a/bindings/java/README.md +++ b/bindings/java/README.md @@ -7,7 +7,10 @@ A native Java binding for Apache OpenDAL™: access S3, GCS, Azure Blob, HDFS, the local filesystem, and many more services through one API. -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to this binding's version rather than the core version. +We release the OpenDAL Java binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Java binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/lua/README.md b/bindings/lua/README.md index 78995488e..3650f7356 100644 --- a/bindings/lua/README.md +++ b/bindings/lua/README.md @@ -5,8 +5,10 @@ A Lua binding for [Apache OpenDAL](https://opendal.apache.org/): access the local filesystem, in-memory storage, S3, and 50+ services through one API. -> **Note**: This binding has its own independent version number, which may -> differ from the Rust core version. +We release the OpenDAL Lua binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Lua binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/nodejs/README.md b/bindings/nodejs/README.md index 38f8d7e2a..cc32e487c 100644 --- a/bindings/nodejs/README.md +++ b/bindings/nodejs/README.md @@ -8,7 +8,10 @@ A native Node.js binding for Apache OpenDAL: access S3, GCS, Azure Blob, HDFS, the local filesystem, and 50+ more services through one API. -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to this binding's version rather than the core version. +We release the OpenDAL Node.js binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Node.js binding version instead of the `opendal` +crate version. ## Useful Links diff --git a/bindings/python/README.md b/bindings/python/README.md index b77924daf..48ebe7fe0 100644 --- a/bindings/python/README.md +++ b/bindings/python/README.md @@ -9,7 +9,10 @@ layer that allows you to access various storage services in a unified way.  -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to this binding's version rather than the core version. +We release the OpenDAL Python binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Python binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/ruby/README.md b/bindings/ruby/README.md index 51c8aefca..4a1c34874 100644 --- a/bindings/ruby/README.md +++ b/bindings/ruby/README.md @@ -7,7 +7,10 @@ OpenDAL's Ruby [gem](https://rubygems.org/gems/opendal): access S3, GCS, Azure B  -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to this binding's version rather than the core version. +We release the OpenDAL Ruby binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Ruby binding version instead of the `opendal` crate +version. ## Useful Links diff --git a/bindings/swift/README.md b/bindings/swift/README.md index 6331a23c5..0882cc585 100644 --- a/bindings/swift/README.md +++ b/bindings/swift/README.md @@ -5,8 +5,10 @@ A Swift binding for OpenDAL. Access storage services through one consistent API backed by the Rust core. **Experimental — not suitable for production use.** -> This binding has its own independent version number. Always check the -> binding's version for compatibility, not the Rust core's version. +We release the OpenDAL Swift binding independently of the +[`opendal` crate](https://crates.io/crates/opendal) (Rust core). For updates +and compatibility, use the Swift binding version instead of the `opendal` crate +version. ## Useful Links
