From bb187896c24171cf27e0e5a332ad6f393b2f773c Mon Sep 17 00:00:00 2001 From: Torrey Payne <11740989+torreypayne@users.noreply.github.com> Date: Thu, 24 Sep 2026 22:09:58 +0000 Subject: [PATCH 1/3] docs: remove stale preview notice and disclaimer from READMEs gapic-common is 1.x and a mandatory runtime dependency of every generated client, yet its README (rendered on devsite via .yardopts --main) still called it a preview and "not an official Google product". Replace the Versioning section with the standard Ruby SDK SemVer wording (stable for gapic-common; major version zero for gapic and google-logging-utils) and drop the Disclaimer section from all three gems. --- gapic-common/README.md | 7 ++----- gapic/README.md | 8 +++----- google-logging-utils/README.md | 8 +++----- 3 files changed, 8 insertions(+), 15 deletions(-) diff --git a/gapic-common/README.md b/gapic-common/README.md index 36d0cca..db49a0c 100644 --- a/gapic-common/README.md +++ b/gapic-common/README.md @@ -61,9 +61,6 @@ See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on ho ## Versioning -This library is currently a **preview** with no guarantees of stability or support. Please get -involved and let us know if you find it useful and we'll work towards a stable version. +This library follows [Semantic Versioning](http://semver.org/). -## Disclaimer - -This is not an official Google product. +This library is considered to be stable and will not have backwards-incompatible changes introduced in subsequent minor releases. diff --git a/gapic/README.md b/gapic/README.md index de40098..e142957 100644 --- a/gapic/README.md +++ b/gapic/README.md @@ -22,9 +22,7 @@ See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on ho ## Versioning -This library is currently a **preview** with no guarantees of stability or support. Please get -involved and let us know if you find it useful and we'll work towards a stable version. +This library follows [Semantic Versioning](http://semver.org/). -## Disclaimer - -This is not an official Google product. +It is currently in major version zero (0.y.z), which means that anything may +change at any time and the public API should not be considered stable. diff --git a/google-logging-utils/README.md b/google-logging-utils/README.md index c5a2b28..5aba942 100644 --- a/google-logging-utils/README.md +++ b/google-logging-utils/README.md @@ -21,9 +21,7 @@ See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on ho ## Versioning -This library is currently a **preview** with no guarantees of stability or support. Please get -involved and let us know if you find it useful and we'll work towards a stable version. +This library follows [Semantic Versioning](http://semver.org/). -## Disclaimer - -This is not an official Google product. +It is currently in major version zero (0.y.z), which means that anything may +change at any time and the public API should not be considered stable. From cb0fd707933fe8718d5d817e060018c880f34e30 Mon Sep 17 00:00:00 2001 From: Torrey Payne <11740989+torreypayne@users.noreply.github.com> Date: Thu, 24 Sep 2026 22:29:32 +0000 Subject: [PATCH 2/3] docs: remove Versioning section instead of replacing it Drop the section entirely rather than adopting stability wording from other gems, so the READMEs make no new versioning commitments. --- gapic-common/README.md | 6 ------ gapic/README.md | 7 ------- google-logging-utils/README.md | 7 ------- 3 files changed, 20 deletions(-) diff --git a/gapic-common/README.md b/gapic-common/README.md index db49a0c..529619c 100644 --- a/gapic-common/README.md +++ b/gapic-common/README.md @@ -58,9 +58,3 @@ ruby -ropenssl -e 'puts OpenSSL::OPENSSL_LIBRARY_VERSION' Contributions to this library are always welcome and highly encouraged. See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on how to get started. - -## Versioning - -This library follows [Semantic Versioning](http://semver.org/). - -This library is considered to be stable and will not have backwards-incompatible changes introduced in subsequent minor releases. diff --git a/gapic/README.md b/gapic/README.md index e142957..4c1c8b4 100644 --- a/gapic/README.md +++ b/gapic/README.md @@ -19,10 +19,3 @@ about the Ruby support schedule. Contributions to this library are always welcome and highly encouraged. See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on how to get started. - -## Versioning - -This library follows [Semantic Versioning](http://semver.org/). - -It is currently in major version zero (0.y.z), which means that anything may -change at any time and the public API should not be considered stable. diff --git a/google-logging-utils/README.md b/google-logging-utils/README.md index 5aba942..6394418 100644 --- a/google-logging-utils/README.md +++ b/google-logging-utils/README.md @@ -18,10 +18,3 @@ about the Ruby support schedule. Contributions to this library are always welcome and highly encouraged. See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on how to get started. - -## Versioning - -This library follows [Semantic Versioning](http://semver.org/). - -It is currently in major version zero (0.y.z), which means that anything may -change at any time and the public API should not be considered stable. From 052d4a872b97d2242284cb2ab51741ffb942b932 Mon Sep 17 00:00:00 2001 From: Torrey Payne <11740989+torreypayne@users.noreply.github.com> Date: Thu, 24 Sep 2026 22:31:41 +0000 Subject: [PATCH 3/3] docs: restore standard Versioning wording Reverts cb0fd70. b/563043219 scope item 2 calls for replacing the preview Versioning section with the standard Ruby SDK wording, not removing it. --- gapic-common/README.md | 6 ++++++ gapic/README.md | 7 +++++++ google-logging-utils/README.md | 7 +++++++ 3 files changed, 20 insertions(+) diff --git a/gapic-common/README.md b/gapic-common/README.md index 529619c..db49a0c 100644 --- a/gapic-common/README.md +++ b/gapic-common/README.md @@ -58,3 +58,9 @@ ruby -ropenssl -e 'puts OpenSSL::OPENSSL_LIBRARY_VERSION' Contributions to this library are always welcome and highly encouraged. See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on how to get started. + +## Versioning + +This library follows [Semantic Versioning](http://semver.org/). + +This library is considered to be stable and will not have backwards-incompatible changes introduced in subsequent minor releases. diff --git a/gapic/README.md b/gapic/README.md index 4c1c8b4..e142957 100644 --- a/gapic/README.md +++ b/gapic/README.md @@ -19,3 +19,10 @@ about the Ruby support schedule. Contributions to this library are always welcome and highly encouraged. See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on how to get started. + +## Versioning + +This library follows [Semantic Versioning](http://semver.org/). + +It is currently in major version zero (0.y.z), which means that anything may +change at any time and the public API should not be considered stable. diff --git a/google-logging-utils/README.md b/google-logging-utils/README.md index 6394418..5aba942 100644 --- a/google-logging-utils/README.md +++ b/google-logging-utils/README.md @@ -18,3 +18,10 @@ about the Ruby support schedule. Contributions to this library are always welcome and highly encouraged. See the [CONTRIBUTING](CONTRIBUTING.md) documentation for more information on how to get started. + +## Versioning + +This library follows [Semantic Versioning](http://semver.org/). + +It is currently in major version zero (0.y.z), which means that anything may +change at any time and the public API should not be considered stable.