You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@opendal.apache.org by er...@apache.org on 2026/07/10 14:14:18 UTC

(opendal) branch doc-binding updated (b694b8f74 -> fc49e6682)

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

erickguan pushed a change to branch doc-binding
in repository https://gitbox.apache.org/repos/asf/opendal.git


 discard b694b8f74 Use plain prose and active tone
     new fc49e6682 Use plain prose and active tone for bindings

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (b694b8f74)
            \
             N -- N -- N   refs/heads/doc-binding (fc49e6682)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 bindings/README.md         | 2 +-
 bindings/c/README.md       | 6 +++---
 bindings/cpp/README.md     | 6 +++---
 bindings/dart/README.md    | 6 +++---
 bindings/dotnet/README.md  | 2 +-
 bindings/go/README.md      | 2 +-
 bindings/haskell/README.md | 2 +-
 bindings/java/README.md    | 2 +-
 bindings/lua/README.md     | 6 +++---
 bindings/nodejs/README.md  | 2 +-
 bindings/python/README.md  | 2 +-
 bindings/ruby/README.md    | 2 +-
 bindings/swift/README.md   | 6 +++---
 13 files changed, 23 insertions(+), 23 deletions(-)


(opendal) 01/01: Use plain prose and active tone for bindings

Posted by er...@apache.org.
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 <29...@users.noreply.github.com>
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://img.shields.io/badge/status-unreleased-red)](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.
 
 ![OpenDAL Python Usage Demo](https://github.com/apache/opendal/assets/5351546/87bbf6e5-f19e-449a-b368-3e283016c887)
 
-> **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
 
 ![](https://github.com/apache/opendal/assets/5351546/87bbf6e5-f19e-449a-b368-3e283016c887)
 
-> **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