doc(compute): update CHANGELOG and other docs for GA (googleapis#12756)

scotthart · web-flow · commit 164d8abdd861 · 2023-09-29T14:59:14.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -115,6 +115,7 @@ info, see [#7463] and [#5976].
 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.
 
+- [Compute Engine](/google/cloud/compute/README.md)
 - [Infrastructure Manager](/google/cloud/config/README.md)
 - [NetApp](/google/cloud/netapp/README.md)
 
diff --git a/google/cloud/compute/README.md b/google/cloud/compute/README.md
@@ -4,6 +4,21 @@ This directory contains an idiomatic C++ client library for the
 [Compute Engine API][cloud-service-docs], a service that lets you create and run
 virtual machines on Google’s infrastructure.
 
+Compute Engine's API has a large surface and is split into multiple services, in
+different subdirectories, each interacting with a specific Compute Engine
+resource. Additionally, Compute Engine is divided into multiple libraries, one
+per resource, to reduce binary size.
+
+CMake targets follow the naming convention
+`google-cloud-cpp::compute_${subdir}`, such that the "disks" library is
+`google-cloud-cpp::compute_disks` and the "instance_group_managers" library is
+`google-cloud-cpp::compute_instance_group_managers`.
+
+Bazel targets follow the naming convention `compute_${subdir}` such that the
+"disks" library is `@google_cloud_cpp//:compute_disks` and the
+"instance_group_managers" library is
+`@google_cloud_cpp//:compute_instance_group_managers`.
+
 ## Quickstart
 
 The [quickstart/](quickstart/README.md) directory contains a minimal environment
diff --git a/google/cloud/compute/doc/main.dox b/google/cloud/compute/doc/main.dox
@@ -2,13 +2,11 @@
 
 @mainpage Compute Engine API C++ Client Library
 
-An idiomatic C++ client library for the [Compute Engine API][cloud-service-docs], a service to create
-and manage cloud computing resources.
+An idiomatic C++ client library for the [Compute Engine API][cloud-service-docs],
+a service to create and manage cloud computing resources.
 
-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]
-on [GitHub][github-link] provides detailed instructions to install the necessary
-dependencies, as well as how to compile the client library.
+While this library is **GA**, please note that the Google Cloud C++ client
+libraries do **not** follow [Semantic Versioning](https://semver.org/).
 
 @tableofcontents{HTML:2}
 
@@ -139,6 +137,4 @@ application.
 - @ref compute-env - describes environment variables that can configure the behavior of the library.
 
 [cloud-service-docs]: https://cloud.google.com/compute
-[exponential backoff]: https://en.wikipedia.org/wiki/Exponential_backoff
-
 */
