Manually update READMEs, quickstart, and top-level stuff

Author: scotthart

CHANGELOG.md

@@ -6,6 +6,13 @@ breaking changes in the upcoming 3.x release. This release is scheduled for
 
 ## v2.45.0 - TBD
 
+### New Libraries
+
+We are happy to announce the following GA libraries. Unless specifically noted,
+the APIs in these libraries are stable, and are ready for production use.
+
+- [Cloud Maintenance API](/google/cloud/maintenance/README.md)
+
 ## v2.44.0 - 2025-12
 
 ### [BigQueryControl](google/cloud/bigquerycontrol/README.md)

cmake/GoogleCloudCppFeatures.cmake

@@ -118,6 +118,7 @@ set(GOOGLE_CLOUD_CPP_GA_LIBRARIES
     "licensemanager"
     "logging"
     "lustre"
+    "maintenance"
     "managedidentities"
     "managedkafka"
     "memcache"

google/cloud/CMakeLists.txt

@@ -52,6 +52,11 @@ mark_as_advanced(GOOGLE_CLOUD_CPP_BUILD_METADATA)
 
 include("${CMAKE_CURRENT_SOURCE_DIR}/google_cloud_cpp_common.cmake")
 
+# We need the REST libraries for the full suite of samples.
+if (BUILD_TESTING AND GOOGLE_CLOUD_CPP_ENABLE_CXX_EXCEPTIONS)
+    set(GOOGLE_CLOUD_CPP_ENABLE_REST ON)
+endif ()
+
 add_subdirectory(testing_util)
 
 if (GOOGLE_CLOUD_CPP_ENABLE_GRPC)
@@ -77,3 +82,10 @@ if (universe_domain IN_LIST GOOGLE_CLOUD_CPP_ENABLE
         "${CMAKE_CURRENT_SOURCE_DIR}/google_cloud_cpp_universe_domain.cmake")
     add_subdirectory(universe_domain)
 endif ()
+
+# We need the universe_domain library for the full suite of samples.
+if (BUILD_TESTING AND GOOGLE_CLOUD_CPP_ENABLE_CXX_EXCEPTIONS)
+    include(
+        "${CMAKE_CURRENT_SOURCE_DIR}/google_cloud_cpp_universe_domain.cmake")
+    add_subdirectory(universe_domain)
+endif ()

google/cloud/maintenance/BUILD.bazel

@@ -21,7 +21,7 @@ licenses(["notice"])  # Apache 2.0
 service_dirs = ["api/v1/"]
 
 googleapis_deps = [
-    "@com_google_googleapis//google/cloud/maintenance/api/v1:maintenance_cc_grpc",
+    "@com_google_googleapis//google/cloud/maintenance/api/v1:api_cc_grpc",
 ]
 
 cc_gapic_library(

google/cloud/maintenance/CMakeLists.txt

@@ -29,8 +29,7 @@ if (BUILD_TESTING AND GOOGLE_CLOUD_CPP_ENABLE_CXX_EXCEPTIONS)
         COMMAND
             cmake -P "${PROJECT_SOURCE_DIR}/cmake/quickstart-runner.cmake"
             $<TARGET_FILE:maintenance_quickstart> GOOGLE_CLOUD_PROJECT
-            GOOGLE_CLOUD_CPP_TEST_REGION # EDIT HERE
-    )
+            GOOGLE_CLOUD_CPP_TEST_REGION)
     set_tests_properties(maintenance_quickstart
                          PROPERTIES LABELS "integration-test;quickstart")
 endif ()

google/cloud/maintenance/README.md

@@ -22,7 +22,7 @@ this library.
 <!-- inject-quickstart-start -->
 
 ```cc
-#include "google/cloud/maintenance/api/v1/ EDIT HERE _client.h"
+#include "google/cloud/maintenance/api/v1/maintenance_client.h"
 #include "google/cloud/location.h"
 #include <iostream>
 
@@ -35,10 +35,10 @@ int main(int argc, char* argv[]) try {
   auto const location = google::cloud::Location(argv[1], argv[2]);
 
   namespace maintenance = ::google::cloud::maintenance_api_v1;
-  auto client = maintenance::ServiceClient(
-      maintenance::MakeServiceConnection());  // EDIT HERE
+  auto client =
+      maintenance::MaintenanceClient(maintenance::MakeMaintenanceConnection());
 
-  for (auto r : client.List /*EDIT HERE*/ (location.FullName())) {
+  for (auto r : client.ListResourceMaintenances(location.FullName())) {
     if (!r) throw std::move(r).status();
     std::cout << r->DebugString() << "\n";
   }

google/cloud/maintenance/api/v1/.repo-metadata.json

@@ -0,0 +1,14 @@
+{
+    "api_id": "maintenance.googleapis.com",
+    "api_shortname": "maintenance",
+    "client_documentation": "https://cloud.google.com/cpp/docs/reference/maintenance/latest",
+    "distribution_name": "google-cloud-cpp",
+    "issue_tracker": "https://issuetracker.google.com/issues/new?component=1673988&template=1161103",
+    "language": "cpp",
+    "library_type": "GAPIC_AUTO",
+    "name_pretty": "Maintenance API",
+    "product_documentation": "https://cloud.google.com/unified-maintenance/docs/overview",
+    "release_level": "stable",
+    "repo": "googleapis/google-cloud-cpp",
+    "requires_billing": true
+}

google/cloud/maintenance/quickstart/quickstart.cc

@@ -13,7 +13,7 @@
 // limitations under the License.
 
 //! [all]
-#include "google/cloud/maintenance/api/v1/ EDIT HERE _client.h"
+#include "google/cloud/maintenance/api/v1/maintenance_client.h"
 #include "google/cloud/location.h"
 #include <iostream>
 
@@ -26,10 +26,10 @@ int main(int argc, char* argv[]) try {
   auto const location = google::cloud::Location(argv[1], argv[2]);
 
   namespace maintenance = ::google::cloud::maintenance_api_v1;
-  auto client = maintenance::ServiceClient(
-      maintenance::MakeServiceConnection());  // EDIT HERE
+  auto client =
+      maintenance::MaintenanceClient(maintenance::MakeMaintenanceConnection());
 
-  for (auto r : client.List /*EDIT HERE*/ (location.FullName())) {
+  for (auto r : client.ListResourceMaintenances(location.FullName())) {
     if (!r) throw std::move(r).status();
     std::cout << r->DebugString() << "\n";
   }

libraries.bzl

@@ -178,6 +178,7 @@ GOOGLE_CLOUD_CPP_GA_LIBRARIES = [
     "licensemanager",
     "logging",
     "lustre",
+    "maintenance",
     "managedidentities",
     "managedkafka",
     "memcache",