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 fc49e6682cefa813f5a320b94e435a494ee5da8e 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 | 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..259e143e5 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. +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..4c8f775c4 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. +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..64f89169a 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. +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..e29433d94 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. +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..d2b027284 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. +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..35e3870d4 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. +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..0d3eec73d 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. +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..264d4ba94 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. +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..7fcef71fa 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. +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..68288acd2 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. +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..cfc85dd98 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. +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..dedcec2c9 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. +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..80225e855 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. +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
