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 b694b8f74c7856fb45c6aec2f02f9441d8d4c602 Author: Erick Guan <[email protected]> AuthorDate: Fri Jul 10 22:11:27 2026 +0800 Use plain prose and active tone --- bindings/README.md | 4 ++-- bindings/c/README.md | 5 +++-- bindings/cpp/README.md | 5 +++-- bindings/dart/README.md | 5 +++-- bindings/dotnet/README.md | 2 +- bindings/go/README.md | 2 +- bindings/haskell/README.md | 2 +- bindings/java/README.md | 2 +- bindings/lua/README.md | 5 +++-- bindings/nodejs/README.md | 2 +- bindings/python/README.md | 2 +- bindings/ruby/README.md | 2 +- bindings/swift/README.md | 5 +++-- 13 files changed, 24 insertions(+), 19 deletions(-) diff --git a/bindings/README.md b/bindings/README.md index f92bd422e..902f31c44 100644 --- a/bindings/README.md +++ b/bindings/README.md @@ -27,9 +27,9 @@ 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. +**Important**: We release each binding independently of the Rust core library. 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 Rust core library 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's version instead of the Rust core library version. ## Getting Started diff --git a/bindings/c/README.md b/bindings/c/README.md index 4fda46e66..21a181fa6 100644 --- a/bindings/c/README.md +++ b/bindings/c/README.md @@ -5,8 +5,9 @@ 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. +> **Note**: We release the C binding independently of the Rust core library. For +> updates and compatibility, use the C binding version instead of the Rust core +> library version. **User guide**: https://opendal.apache.org/docs/bindings/c diff --git a/bindings/cpp/README.md b/bindings/cpp/README.md index 4007a61a0..5ab74bb1e 100644 --- a/bindings/cpp/README.md +++ b/bindings/cpp/README.md @@ -8,8 +8,9 @@ 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. +> **Note**: We release the C++ binding independently of the Rust core library. +> For updates and compatibility, use the C++ binding version instead of the Rust +> core library version. ## Useful Links diff --git a/bindings/dart/README.md b/bindings/dart/README.md index c5cdd14ad..0a8edb604 100644 --- a/bindings/dart/README.md +++ b/bindings/dart/README.md @@ -4,8 +4,9 @@ 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. +> **Note**: We release the Dart binding independently of the Rust core library. +> For updates and compatibility, use the Dart binding version instead of the Rust +> core library version. ## Useful Links diff --git a/bindings/dotnet/README.md b/bindings/dotnet/README.md index 73b20c47c..6892f8150 100644 --- a/bindings/dotnet/README.md +++ b/bindings/dotnet/README.md @@ -5,7 +5,7 @@ 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. +> **Note**: We release the .NET binding independently of the Rust core library. For updates and compatibility, use the .NET binding version instead of the Rust core library version. ## Useful Links diff --git a/bindings/go/README.md b/bindings/go/README.md index e35b33745..6334249e8 100644 --- a/bindings/go/README.md +++ b/bindings/go/README.md @@ -5,7 +5,7 @@ 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. +> **Note**: We release the Go binding independently of the Rust core library. For updates and compatibility, use the Go binding version instead of the Rust core library version. ## Useful Links diff --git a/bindings/haskell/README.md b/bindings/haskell/README.md index 58a6ab93d..de1a0aff5 100644 --- a/bindings/haskell/README.md +++ b/bindings/haskell/README.md @@ -2,7 +2,7 @@ [](https://opendal.apache.org/docs/bindings/haskell) -> **Note**: This binding has its own independent version number, which may differ from the Rust core version. +> **Note**: We release the Haskell binding independently of the Rust core library. For updates and compatibility, use the Haskell binding version instead of the Rust core library 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..e4ef4db9f 100644 --- a/bindings/java/README.md +++ b/bindings/java/README.md @@ -7,7 +7,7 @@ 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. +> **Note**: We release the Java binding independently of the Rust core library. For updates and compatibility, use the Java binding version instead of the Rust core library version. ## Useful Links diff --git a/bindings/lua/README.md b/bindings/lua/README.md index 78995488e..dbcfc34a5 100644 --- a/bindings/lua/README.md +++ b/bindings/lua/README.md @@ -5,8 +5,9 @@ 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. +> **Note**: We release the Lua binding independently of the Rust core library. +> For updates and compatibility, use the Lua binding version instead of the Rust +> core library version. ## Useful Links diff --git a/bindings/nodejs/README.md b/bindings/nodejs/README.md index 38f8d7e2a..f405c5062 100644 --- a/bindings/nodejs/README.md +++ b/bindings/nodejs/README.md @@ -8,7 +8,7 @@ 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. +> **Note**: We release the Node.js binding independently of the Rust core library. For updates and compatibility, use the Node.js binding version instead of the Rust core library version. ## Useful Links diff --git a/bindings/python/README.md b/bindings/python/README.md index b77924daf..caacebf48 100644 --- a/bindings/python/README.md +++ b/bindings/python/README.md @@ -9,7 +9,7 @@ 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. +> **Note**: We release the Python binding independently of the Rust core library. For updates and compatibility, use the Python binding version instead of the Rust core library version. ## Useful Links diff --git a/bindings/ruby/README.md b/bindings/ruby/README.md index 51c8aefca..a3d0fd137 100644 --- a/bindings/ruby/README.md +++ b/bindings/ruby/README.md @@ -7,7 +7,7 @@ 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. +> **Note**: We release the Ruby binding independently of the Rust core library. For updates and compatibility, use the Ruby binding version instead of the Rust core library version. ## Useful Links diff --git a/bindings/swift/README.md b/bindings/swift/README.md index 6331a23c5..7a0dd88b7 100644 --- a/bindings/swift/README.md +++ b/bindings/swift/README.md @@ -5,8 +5,9 @@ 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. +> **Note**: We release the Swift binding independently of the Rust core library. +> For updates and compatibility, use the Swift binding version instead of the +> Rust core library version. ## Useful Links
