From 600ebfaaa79484abb408c9072844e90042b944e6 Mon Sep 17 00:00:00 2001
From: Tres Seaver <tseaver@palladion.com>
Date: Wed, 19 Jun 2019 17:14:42 -0400
Subject: [PATCH] Repair top-level API reference page.

Supersedes #7645.

Fixes #7629.
---
 texttospeech/docs/api.rst | 43 +++++++++++++++++++--------------------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/texttospeech/docs/api.rst b/texttospeech/docs/api.rst
index 32998d183a9a..8dd5fb3fdda2 100644
--- a/texttospeech/docs/api.rst
+++ b/texttospeech/docs/api.rst
@@ -1,31 +1,30 @@
-API Reference
-=============
+Text-to-Speech Client API Reference
+===================================
 
-APIs
-----
+This package includes clients for multiple versions of the Text-to-Speech
+API. By default, you will get ``v1``, the latest GA version.
 
-.. autosummary::
+.. toctree::
+  :maxdepth: 2
 
-.. :toctree::
+  gapic/v1/api
+  gapic/v1/types
 
-   google.cloud.texttospeech_v1.trace_service_client
+If you are interested in beta features ahead of the latest GA, you may
+opt-in to the v1.1 beta, which is spelled ``v1beta1``. In order to do this,
+you will want to import from ``google.cloud.texttospeech_v1beta1`` in lieu of
+``google.cloud.texttospeech``.
 
+An API and type reference is provided for the v1.1 beta also:
 
-API types
-~~~~~~~~~
+.. toctree::
+  :maxdepth: 2
 
-.. autosummary::
-.. :toctree::
+  gapic/v1beta1/api
+  gapic/v1beta1/types
 
-   google.cloud.trace_v1
-
-
-API types
-~~~~~~~~~
-
-.. autosummary::
-.. :toctree::
-
-   google.cloud.trace_v1.gapic.enums
-   google.cloud.trace_v1.gapic.types
+.. note::
 
+  The client for the beta API is provided on a provisional basis. The API
+  surface is subject to change, and it is possible that this client will be
+  deprecated or removed after its features become GA.