doc(v3): update top level docs #15956

scotthart · 2026-02-11T19:21:29Z

This change is

gemini-code-assist · 2026-02-11T19:21:53Z

Summary of Changes

Hello @scotthart, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request primarily focuses on updating the project's documentation and build system configurations to align with newer minimum version requirements for essential tools and third-party libraries. It reflects a shift to C++17 as the baseline standard and streamlines information by removing outdated deprecation notices and consolidating platform support details.

Highlights

Minimum Version Updates: The minimum required versions for CMake, Bazel, and Clang have been updated across the project's build configurations and documentation. CMake now requires 3.22, Bazel 7.0, and Clang 14.0.0.
C++ Standard Bump: The project's required C++ standard has been increased from C++14 to C++17, affecting both build configurations and documentation.
Third-Party Dependency Updates: Minimum versions for several third-party libraries, including Abseil, gRPC, libcurl, OpenSSL, nlohmann/json, Protobuf, and OpenTelemetry, have been revised in the packaging documentation.
Dependency Removal: The crc32c library has been removed as a direct dependency from the project's build and packaging configurations.
Documentation Cleanup: Outdated information regarding deprecated features has been removed from doc/deprecated.md, and the next major version mentioned has been updated to 4.x. The 'Supported Platforms' section was also removed from google/cloud/README.md.

Changelog

CMakeLists.txt
- Updated cmake_minimum_required from 3.16...3.31 to 3.22...3.31.
- Updated minimum Clang version check from 6.0 to 14.0.0.
- Removed the MSVC-specific CMake version check.
README.md
- Updated required Bazel version from 6.0 to 7.0.
- Updated required CMake version from 3.10 to 3.22.
- Updated required C++ Language Version from C++14 to C++17.
- Updated required Compilers: Clang from 6.0 to 14.0.0, Apple Clang from 12 to 17.
doc/compile-time-configuration.md
- Updated the default Bazel toolchain C++ standard from C++11 to C++17 and the required standard from C++14 to C++17.
- Updated Bazel CXX options from -std=c++14 to -std=c++17.
- Removed the 'Enabling OpenTelemetry' section and its quickstart link.
doc/deprecated.md
- Updated the next major version from 3.x to 4.x.
- Removed details for Bigtable DataClient finalization, Bigtable RowReader constructors, BigQuery BigQueryReadReadRowsStreamingUpdater, Spanner legacy admin APIs, spanner::MakeTestRow(), Storage oauth2 namespace, and common libraries v1/gcpcxxV1 aliases.
- Removed associated issue links.
doc/packaging.md
- Updated minimum versions for Abseil (20200923 -> 20250814), gRPC (1.35.x -> 1.76.x), libcurl (7.47.0 -> 7.74.0), OpenSSL (1.0.2 -> 3.0.17), nlohmann/json (3.4.0 -> 3.12.0), Protobuf (3.15.8 -> 6.33.x), and OpenTelemetry (1.9.1 -> 1.23.0).
- Removed crc32c from the dependency list.
- Removed footnotes related to crc32c.
- Removed crc32c-gh link.
google/cloud/README.md
- Removed the 'Supported Platforms' section, including details on OS, C++ standard, compilers, and build systems.
vcpkg.json
- Removed crc32c from dependencies.
- Changed opentelemetry-cpp from an optional dependency with a description to a direct dependency.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This pull request updates documentation and configuration files for the next major version. The changes include bumping minimum versions for dependencies like CMake, Bazel, and compilers, and updating the required C++ standard to C++17. Several documentation files are updated to reflect these changes, including removing obsolete deprecation notices. My review found a couple of minor inconsistencies in the documentation that could be improved for clarity. Overall, the changes look good and are consistent with a major version release.

gemini-code-assist · 2026-02-11T19:26:01Z

doc/compile-time-configuration.md

+The default Bazel toolchain forces C++17 on Linux and macOS. `google-cloud-cpp`
+requires C++17, so you will need to update the C++ standard version. You must


This sentence is a bit confusing. It states that the default toolchain and the library both require C++17, but then says an update is needed. Suggest rephrasing for clarity.

Suggested change

The default Bazel toolchain forces C++17 on Linux and macOS. `google-cloud-cpp`

requires C++17, so you will need to update the C++ standard version. You must

`google-cloud-cpp` requires C++17. You must ensure your Bazel toolchain is

configured to use C++17 or a newer standard. You must either:

gemini-code-assist · 2026-02-11T19:26:01Z

doc/packaging.md

+| [OpenSSL][openssl-gh]             |            3.0.17 | Crypto functions for [^3]                                  |
+| [nlohmann/json][nlohmann-json-gh] |            3.12.0 | JSON for Modern C++ [^3]                                   |
+| [protobuf][protobuf-gh]           |            6.33.x | Protobuf is needed for any library based on gRPC [^5] [^6] |
+| [OpenTelemetry][opentelemetry-gh] |            1.23.0 | An observability framework[^7]                             |


With OpenTelemetry now being a required dependency, the referenced footnote [^7] is outdated as it still refers to it as an 'optional dependency'. Suggest removing the reference to avoid confusion.

Suggested change

| [OpenTelemetry][opentelemetry-gh] | 1.23.0 | An observability framework[^7] |

| [OpenTelemetry][opentelemetry-gh] | 1.23.0 | An observability framework |

Updated footnote.

diegomarquezp

LGTM, just one qq

diegomarquezp · 2026-02-11T19:52:41Z

google/cloud/README.md

 notice. These include `google/cloud/internal/`, and
 `google/cloud/testing_utils/`.

-## Supported Platforms


qq: Why is this section being removed? Is 3.x compatible with all common platforms?

That same information already exists in the top level README.md. It was duplicated here and didn't seem necessary to keep both.

codecov · 2026-02-11T20:38:37Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.62%. Comparing base (7077419) to head (56958cf).
⚠️ Report is 2 commits behind head on prepare-for-v3.0.0.

Additional details and impacted files

@@                 Coverage Diff                 @@
##           prepare-for-v3.0.0   #15956   +/-   ##
===================================================
  Coverage               92.61%   92.62%           
===================================================
  Files                    2332     2332           
  Lines                  213322   213322           
===================================================
+ Hits                   197574   197587   +13     
+ Misses                  15748    15735   -13

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

scotthart temporarily deployed to false February 11, 2026 19:21 — with GitHub Actions Inactive

gemini-code-assist bot reviewed Feb 11, 2026

View reviewed changes

scotthart temporarily deployed to false February 11, 2026 19:36 — with GitHub Actions Inactive

scotthart added 2 commits February 11, 2026 14:43

doc(v3): update top level docs

8e6b2bf

address comments

56958cf

scotthart force-pushed the v3_update_docs branch from 642f856 to 56958cf Compare February 11, 2026 19:43

scotthart deployed to false February 11, 2026 19:43 — with GitHub Actions Active

diegomarquezp approved these changes Feb 11, 2026

View reviewed changes

scotthart merged commit 0c61457 into googleapis:prepare-for-v3.0.0 Feb 11, 2026
56 of 63 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc(v3): update top level docs #15956

doc(v3): update top level docs #15956

scotthart commented Feb 11, 2026 •

edited

Loading

Uh oh!

gemini-code-assist bot commented Feb 11, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

gemini-code-assist bot Feb 11, 2026

Uh oh!

scotthart Feb 11, 2026

Uh oh!

gemini-code-assist bot Feb 11, 2026

Uh oh!

scotthart Feb 11, 2026

Uh oh!

diegomarquezp left a comment

Uh oh!

diegomarquezp Feb 11, 2026

Uh oh!

scotthart Feb 11, 2026

Uh oh!

codecov bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		The default Bazel toolchain forces C++17 on Linux and macOS. `google-cloud-cpp`
		requires C++17, so you will need to update the C++ standard version. You must

	\| [OpenTelemetry][opentelemetry-gh] \| 1.23.0 \| An observability framework[^7] \|
	\| [OpenTelemetry][opentelemetry-gh] \| 1.23.0 \| An observability framework \|

doc(v3): update top level docs #15956

doc(v3): update top level docs #15956

Conversation

scotthart commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gemini-code-assist bot commented Feb 11, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist bot Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

scotthart Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

scotthart Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

diegomarquezp left a comment

Choose a reason for hiding this comment

Uh oh!

diegomarquezp Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

scotthart Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

codecov bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

scotthart commented Feb 11, 2026 •

edited

Loading

codecov bot commented Feb 11, 2026 •

edited

Loading