docs: augment the documentation at https://godoc.org/google.golang.org/api
Adds high-level description of clients, adds versioning and stability
information, and fixes a reference.
Change-Id: I2aac8d8a80ae326983b51a43bb85078a614f927c
Reviewed-on: https://code-review.googlesource.com/c/google-api-go-client/+/39071
Reviewed-by: kokoro <noreply+kokoro@google.com>
Reviewed-by: Tyler Bui-Palsulich <tbp@google.com>
diff --git a/doc.go b/doc.go
index 49754a8..c8034c2 100644
--- a/doc.go
+++ b/doc.go
@@ -6,6 +6,9 @@
// Services. See https://godoc.org/google.golang.org/api for a full list of
// sub-packages.
//
+// Within api there exist numerous clients which connect to Google APIs,
+// and various utility packages.
+//
//
// Client Options
//
@@ -18,6 +21,16 @@
// All the clients in sub-packages support authentication via Google
// Application Default Credentials (see
// https://cloud.google.com/docs/authentication/production), or by providing a
-// JSON key file for a Service Account. See the authentication examples in this
-// package for details.
+// JSON key file for a Service Account. See the authentication examples in
+// https://godoc.org/google.golang.org/api/transport for more details.
+//
+//
+// Versioning and Stability
+//
+// Clients in these subpackages follow semver as specified in
+// https://cloud.google.com/apis/design/versioning.
+//
+// Note that versioning and stability is strictly not communicated through Go
+// modules. Go modules are used only for dependency management. See the link
+// above for stability guarantees.
package api
