doc: video, baremetalsolution, and optimization are GA (#9704)

BUILD.bazel

@@ -28,16 +28,15 @@ EXPERIMENTAL_LIBRARIES = [
     # Introduced circa 2022-07-12
     "batch",
     "run",
-    # Introduced circa 2022-06-22
-    "video",
-    # Introduced in 2022-05
-    "baremetalsolution",
-    "optimization",
     # This is WIP, it needs a number of hand-crafted APIs.
     "pubsublite",
 ]
 
 TRANSITION_LIBRARIES = [
+    # Declared GA circa 2022-08-17
+    "video",
+    "baremetalsolution",
+    "optimization",
     # Declared GA on 2022-07-18
     "osconfig",
 ]

CHANGELOG.md

@@ -134,6 +134,19 @@ releasing them early in case they elicit some feedback that requires changes.
 
 * [API Keys](/google/cloud/apikeys/README.md)
 
+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.
+
+<details>
+<summary> Expand to see the full list of new GA libraries...</summary>
+<br>
+
+* [Bare Metal Solution](/google/cloud/baremetalsolution/README.md)
+* [Optimization AI](/google/cloud/optimization/README.md)
+* [Video Services](/google/cloud/video/README.md)
+
+</details>
+
 ### [Storage](/google/cloud/storage/README.md)
 
 * We have a new implementation for HTTP requests. This new implementation

README.md

@@ -63,6 +63,9 @@ This repository contains idiomatic C++ client libraries for the following
 * [Cloud AutoML API](google/cloud/automl/README.md)
   [[quickstart]](google/cloud/automl/quickstart/README.md)
   [[reference]](https://googleapis.dev/cpp/google-cloud-automl/latest)
+* [Bare Metal Solution API](google/cloud/baremetalsolution/README.md)
+  [[quickstart]](google/cloud/baremetalsolution/quickstart/README.md)
+  [[reference]](https://googleapis.dev/cpp/google-cloud-baremetalsolution/latest)
 * [Google Cloud BigQuery](google/cloud/bigquery/README.md)
   [[quickstart]](google/cloud/bigquery/quickstart/README.md)
   [[reference]](https://googleapis.dev/cpp/google-cloud-bigquery/latest)
@@ -171,6 +174,9 @@ This repository contains idiomatic C++ client libraries for the following
 * [Notebooks API](google/cloud/notebooks/README.md)
   [[quickstart]](google/cloud/notebooks/quickstart/README.md)
   [[reference]](https://googleapis.dev/cpp/google-cloud-notebooks/latest)
+* [Cloud Optimization API](google/cloud/optimization/README.md)
+  [[quickstart]](google/cloud/optimization/quickstart/README.md)
+  [[reference]](https://googleapis.dev/cpp/google-cloud-optimization/latest)
 * [Organization Policy API](google/cloud/orgpolicy/README.md)
   [[quickstart]](google/cloud/orgpolicy/quickstart/README.md)
   [[reference]](https://googleapis.dev/cpp/google-cloud-orgpolicy/latest)
@@ -261,6 +267,9 @@ This repository contains idiomatic C++ client libraries for the following
 * [Cloud Translation API](google/cloud/translate/README.md)
   [[quickstart]](google/cloud/translate/quickstart/README.md)
   [[reference]](https://googleapis.dev/cpp/google-cloud-translate/latest)
+* [Video Services](google/cloud/video/README.md)
+  [[quickstart]](google/cloud/video/quickstart/README.md)
+  [[reference]](https://googleapis.dev/cpp/google-cloud-video/latest)
 * [Cloud Video Intelligence API](google/cloud/videointelligence/README.md)
   [[quickstart]](google/cloud/videointelligence/quickstart/README.md)
   [[reference]](https://googleapis.dev/cpp/google-cloud-videointelligence/latest)

google/cloud/baremetalsolution/CMakeLists.txt

@@ -18,7 +18,7 @@ include(GoogleapisConfig)
 set(DOXYGEN_PROJECT_NAME "Bare Metal Solution API C++ Client")
 set(DOXYGEN_PROJECT_BRIEF
     "A C++ Client Library for the Bare Metal Solution API")
-set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION} (Experimental)")
+set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION}")
 set(DOXYGEN_EXCLUDE_SYMBOLS "internal" "baremetalsolution_internal"
                             "baremetalsolution_testing" "examples")
 set(DOXYGEN_EXAMPLE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/quickstart)
@@ -70,13 +70,13 @@ target_link_libraries(
 google_cloud_cpp_add_common_options(google_cloud_cpp_baremetalsolution)
 set_target_properties(
     google_cloud_cpp_baremetalsolution
-    PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-baremetalsolution
+    PROPERTIES EXPORT_NAME google-cloud-cpp::baremetalsolution
                VERSION "${PROJECT_VERSION}"
                SOVERSION "${PROJECT_VERSION_MAJOR}")
 target_compile_options(google_cloud_cpp_baremetalsolution
                        PUBLIC ${GOOGLE_CLOUD_CPP_EXCEPTIONS_FLAG})
 
-add_library(google-cloud-cpp::experimental-baremetalsolution ALIAS
+add_library(google-cloud-cpp::baremetalsolution ALIAS
             google_cloud_cpp_baremetalsolution)
 
 # Create a header-only library for the mocks. We use a CMake `INTERFACE` library
@@ -96,12 +96,11 @@ add_library(google_cloud_cpp_baremetalsolution_mocks INTERFACE)
 target_sources(google_cloud_cpp_baremetalsolution_mocks INTERFACE ${mock_files})
 target_link_libraries(
     google_cloud_cpp_baremetalsolution_mocks
-    INTERFACE google-cloud-cpp::experimental-baremetalsolution
-              GTest::gmock_main GTest::gmock GTest::gtest)
+    INTERFACE google-cloud-cpp::baremetalsolution GTest::gmock_main
+              GTest::gmock GTest::gtest)
 set_target_properties(
     google_cloud_cpp_baremetalsolution_mocks
-    PROPERTIES EXPORT_NAME
-               google-cloud-cpp::experimental-baremetalsolution_mocks)
+    PROPERTIES EXPORT_NAME google-cloud-cpp::baremetalsolution_mocks)
 target_include_directories(
     google_cloud_cpp_baremetalsolution_mocks
     INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>
@@ -113,9 +112,8 @@ target_compile_options(google_cloud_cpp_baremetalsolution_mocks
 include(CTest)
 if (BUILD_TESTING)
     add_executable(baremetalsolution_quickstart "quickstart/quickstart.cc")
-    target_link_libraries(
-        baremetalsolution_quickstart
-        PRIVATE google-cloud-cpp::experimental-baremetalsolution)
+    target_link_libraries(baremetalsolution_quickstart
+                          PRIVATE google-cloud-cpp::baremetalsolution)
     google_cloud_cpp_add_common_options(baremetalsolution_quickstart)
     add_test(
         NAME baremetalsolution_quickstart

google/cloud/baremetalsolution/README.md

@@ -1,15 +1,11 @@
 # Bare Metal Solution API C++ Client Library
 
-:construction:
-
 [Bare Metal Solution API][cloud-service-root], a service that provides ways to
 manage Bare Metal Solution hardware installed in a regional extension located
 near a Google Cloud data center.
 
-This library is **experimental**. Its APIs are subject to change without notice.
-
-Please note that the Google Cloud C++ client libraries do **not** follow
-[Semantic Versioning](https://semver.org/).
+While this library is **GA**, please note that the Google Cloud C++
+client libraries do **not** follow [Semantic Versioning](https://semver.org/).
 
 ## Supported Platforms
 

google/cloud/baremetalsolution/config.cmake.in

@@ -20,3 +20,7 @@ find_dependency(google_cloud_cpp_grpc_utils)
 find_dependency(absl)
 
 include("${CMAKE_CURRENT_LIST_DIR}/google_cloud_cpp_baremetalsolution-targets.cmake")
+
+if (NOT TARGET google-cloud-cpp::experimental-baremetalsolution)
+    add_library(google-cloud-cpp::experimental-baremetalsolution ALIAS google-cloud-cpp::baremetalsolution)
+endif ()

google/cloud/baremetalsolution/doc/main.dox

@@ -6,7 +6,8 @@ An idiomatic C++ client library for the [Bare Metal Solution API][cloud-service-
 a service that provides ways to manage Bare Metal Solution hardware installed in
 a regional extension located near a Google Cloud data center.
 
-This library is **experimental**. Its APIs are subject to change without notice.
+While this library is **GA**, please note Google Cloud C++ client libraries do
+**not** follow [Semantic Versioning](https://semver.org/).
 
 This library requires a C++14 compiler. It is supported (and tested) on multiple
 Linux distributions, as well as Windows and macOS. The [README][github-readme]

google/cloud/optimization/CMakeLists.txt

@@ -17,7 +17,7 @@
 include(GoogleapisConfig)
 set(DOXYGEN_PROJECT_NAME "Cloud Optimization API C++ Client")
 set(DOXYGEN_PROJECT_BRIEF "A C++ Client Library for the Cloud Optimization API")
-set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION} (Experimental)")
+set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION}")
 set(DOXYGEN_EXCLUDE_SYMBOLS "internal" "optimization_internal"
                             "optimization_testing" "examples")
 set(DOXYGEN_EXAMPLE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/quickstart)
@@ -66,14 +66,13 @@ target_link_libraries(
 google_cloud_cpp_add_common_options(google_cloud_cpp_optimization)
 set_target_properties(
     google_cloud_cpp_optimization
-    PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-optimization
+    PROPERTIES EXPORT_NAME google-cloud-cpp::optimization
                VERSION "${PROJECT_VERSION}"
                SOVERSION "${PROJECT_VERSION_MAJOR}")
 target_compile_options(google_cloud_cpp_optimization
                        PUBLIC ${GOOGLE_CLOUD_CPP_EXCEPTIONS_FLAG})
 
-add_library(google-cloud-cpp::experimental-optimization ALIAS
-            google_cloud_cpp_optimization)
+add_library(google-cloud-cpp::optimization ALIAS google_cloud_cpp_optimization)
 
 # Create a header-only library for the mocks. We use a CMake `INTERFACE` library
 # for these, a regular library would not work on macOS (where the library needs
@@ -92,11 +91,11 @@ add_library(google_cloud_cpp_optimization_mocks INTERFACE)
 target_sources(google_cloud_cpp_optimization_mocks INTERFACE ${mock_files})
 target_link_libraries(
     google_cloud_cpp_optimization_mocks
-    INTERFACE google-cloud-cpp::experimental-optimization GTest::gmock_main
-              GTest::gmock GTest::gtest)
+    INTERFACE google-cloud-cpp::optimization GTest::gmock_main GTest::gmock
+              GTest::gtest)
 set_target_properties(
     google_cloud_cpp_optimization_mocks
-    PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-optimization_mocks)
+    PROPERTIES EXPORT_NAME google-cloud-cpp::optimization_mocks)
 target_include_directories(
     google_cloud_cpp_optimization_mocks
     INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>
@@ -109,7 +108,7 @@ include(CTest)
 if (BUILD_TESTING)
     add_executable(optimization_quickstart "quickstart/quickstart.cc")
     target_link_libraries(optimization_quickstart
-                          PRIVATE google-cloud-cpp::experimental-optimization)
+                          PRIVATE google-cloud-cpp::optimization)
     google_cloud_cpp_add_common_options(optimization_quickstart)
     add_test(
         NAME optimization_quickstart

google/cloud/optimization/README.md

@@ -1,15 +1,11 @@
 # Cloud Optimization API C++ Client Library
 
-:construction:
-
 This directory contains an idiomatic C++ client library for the
 [Cloud Optimization API][cloud-service-root], a service that provides a
 portfolio of solvers to address common optimization use cases.
 
-This library is **experimental**. Its APIs are subject to change without notice.
-
-Please note that the Google Cloud C++ client libraries do **not** follow
-[Semantic Versioning](https://semver.org/).
+While this library is **GA**, please note that the Google Cloud C++
+client libraries do **not** follow [Semantic Versioning](https://semver.org/).
 
 ## Supported Platforms
 

google/cloud/optimization/config.cmake.in

@@ -20,3 +20,7 @@ find_dependency(google_cloud_cpp_grpc_utils)
 find_dependency(absl)
 
 include("${CMAKE_CURRENT_LIST_DIR}/google_cloud_cpp_optimization-targets.cmake")
+
+if (NOT TARGET google-cloud-cpp::experimental-optimization)
+    add_library(google-cloud-cpp::experimental-optimization ALIAS google-cloud-cpp::optimization)
+endif ()

google/cloud/optimization/doc/main.dox

@@ -6,7 +6,8 @@ This directory contains an idiomatic C++ client library for the
 [Cloud Optimization API][cloud-service-docs], a service that provides a
 portfolio of solvers to address common optimization use cases.
 
-This library is **experimental**. Its APIs are subject to change without notice.
+While this library is **GA**, please note Google Cloud C++ client libraries do
+**not** follow [Semantic Versioning](https://semver.org/).
 
 This library requires a C++14 compiler. It is supported (and tested) on multiple
 Linux distributions, as well as Windows and macOS. The [README][github-readme]

google/cloud/video/CMakeLists.txt

@@ -17,7 +17,7 @@
 include(GoogleapisConfig)
 set(DOXYGEN_PROJECT_NAME "Transcoder API C++ Client")
 set(DOXYGEN_PROJECT_BRIEF "A C++ Client Library for the Transcoder API")
-set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION} (Experimental)")
+set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION}")
 set(DOXYGEN_EXCLUDE_SYMBOLS "internal" "video_internal" "video_testing"
                             "examples")
 set(DOXYGEN_EXAMPLE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/quickstart)
@@ -65,13 +65,13 @@ target_link_libraries(
 google_cloud_cpp_add_common_options(google_cloud_cpp_video)
 set_target_properties(
     google_cloud_cpp_video
-    PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-video
+    PROPERTIES EXPORT_NAME google-cloud-cpp::video
                VERSION "${PROJECT_VERSION}"
                SOVERSION "${PROJECT_VERSION_MAJOR}")
 target_compile_options(google_cloud_cpp_video
                        PUBLIC ${GOOGLE_CLOUD_CPP_EXCEPTIONS_FLAG})
 
-add_library(google-cloud-cpp::experimental-video ALIAS google_cloud_cpp_video)
+add_library(google-cloud-cpp::video ALIAS google_cloud_cpp_video)
 
 # Create a header-only library for the mocks. We use a CMake `INTERFACE` library
 # for these, a regular library would not work on macOS (where the library needs
@@ -90,11 +90,10 @@ add_library(google_cloud_cpp_video_mocks INTERFACE)
 target_sources(google_cloud_cpp_video_mocks INTERFACE ${mock_files})
 target_link_libraries(
     google_cloud_cpp_video_mocks
-    INTERFACE google-cloud-cpp::experimental-video GTest::gmock_main
-              GTest::gmock GTest::gtest)
-set_target_properties(
-    google_cloud_cpp_video_mocks
-    PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-video_mocks)
+    INTERFACE google-cloud-cpp::video GTest::gmock_main GTest::gmock
+              GTest::gtest)
+set_target_properties(google_cloud_cpp_video_mocks
+                      PROPERTIES EXPORT_NAME google-cloud-cpp::video_mocks)
 target_include_directories(
     google_cloud_cpp_video_mocks
     INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>
@@ -106,8 +105,7 @@ target_compile_options(google_cloud_cpp_video_mocks
 include(CTest)
 if (BUILD_TESTING)
     add_executable(video_quickstart "quickstart/quickstart.cc")
-    target_link_libraries(video_quickstart
-                          PRIVATE google-cloud-cpp::experimental-video)
+    target_link_libraries(video_quickstart PRIVATE google-cloud-cpp::video)
     google_cloud_cpp_add_common_options(video_quickstart)
     add_test(
         NAME video_quickstart

google/cloud/video/README.md

@@ -1,6 +1,4 @@
-# Transcoder API C++ Client Library
-
-:construction:
+# Video Services C++ Client Library
 
 This directory contains an idiomatic C++ client library for video services,
 including:
@@ -13,10 +11,8 @@ including:
   servers to dynamically insert ads into video-on-demand and live streams for
   your users.
 
-This library is **experimental**. Its APIs are subject to change without notice.
-
-Please note that the Google Cloud C++ client libraries do **not** follow
-[Semantic Versioning](https://semver.org/).
+While this library is **GA**, please note that the Google Cloud C++
+client libraries do **not** follow [Semantic Versioning](https://semver.org/).
 
 ## Supported Platforms
 

google/cloud/video/config.cmake.in

@@ -20,3 +20,7 @@ find_dependency(google_cloud_cpp_grpc_utils)
 find_dependency(absl)
 
 include("${CMAKE_CURRENT_LIST_DIR}/google_cloud_cpp_video-targets.cmake")
+
+if (NOT TARGET google-cloud-cpp::experimental-video)
+    add_library(google-cloud-cpp::experimental-video ALIAS google-cloud-cpp::video)
+endif ()

google/cloud/video/doc/main.dox

@@ -12,7 +12,8 @@ An idiomatic C++ client library for video services, including:
   servers to dynamically insert ads into video-on-demand and live streams for
   your users.
 
-This library is **experimental**. Its APIs are subject to change without notice.
+While this library is **GA**, please note Google Cloud C++ client libraries do
+**not** follow [Semantic Versioning](https://semver.org/).
 
 This library requires a C++14 compiler. It is supported (and tested) on multiple
 Linux distributions, as well as Windows and macOS. The [README][github-readme]