docs(spanner): changes to support sphinx new release (#54)

* docs(spanner): changes to support sphinx new release

* docs(spanner): variable fix in changelog file

* docs(spanner): nit

CHANGELOG.md

@@ -106,12 +106,12 @@ Return sessions from pool in LIFO order. ([#9454](https://github.com/googleapis/
 
 
 ### Implementation Changes
-- Add backoff for `run_in_transaction' when backend does not provide 'RetryInfo' in response. ([#8461](https://github.com/googleapis/google-cloud-python/pull/8461))
+- Add backoff for `run_in_transaction` when backend does not provide 'RetryInfo' in response. ([#8461](https://github.com/googleapis/google-cloud-python/pull/8461))
 - Adjust gRPC timeouts (via synth). ([#8445](https://github.com/googleapis/google-cloud-python/pull/8445))
 - Allow kwargs to be passed to create_channel (via synth). ([#8403](https://github.com/googleapis/google-cloud-python/pull/8403))
 
 ### New Features
-- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8659](https://github.com/googleapis/google-cloud-python/pull/8659))
+- Add 'options_' argument to clients 'get_iam_policy'; pin black version (via synth). ([#8659](https://github.com/googleapis/google-cloud-python/pull/8659))
 - Add 'client_options' support, update list method docstrings (via synth). ([#8522](https://github.com/googleapis/google-cloud-python/pull/8522))
 
 ### Dependencies
@@ -382,6 +382,6 @@ Return sessions from pool in LIFO order. ([#9454](https://github.com/googleapis/
 - Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
   on `google-api-core` (#4221, #4280)
 - Deferring to `google-api-core` for `grpcio` and
-  `googleapis-common-protos`dependencies (#4096, #4098)
+  `googleapis-common-protos` dependencies (#4096, #4098)
 
 PyPI: https://pypi.org/project/google-cloud-spanner/0.29.0/

docs/conf.py

@@ -38,6 +38,7 @@
     "sphinx.ext.napoleon",
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",
+    "recommonmark",
 ]
 
 # autodoc/autosummary flags

docs/gapic/v1/admin_database_types.rst

@@ -3,3 +3,4 @@ Spanner Admin Database Client Types
 
 .. automodule:: google.cloud.spanner_admin_database_v1.types
   :members:
+  :noindex:

docs/gapic/v1/admin_instance_types.rst

@@ -3,3 +3,4 @@ Spanner Admin Instance Client Types
 
 .. automodule:: google.cloud.spanner_admin_instance_v1.types
   :members:
+  :noindex:

docs/gapic/v1/types.rst

@@ -3,3 +3,4 @@ Spanner Client Types
 
 .. automodule:: google.cloud.spanner_v1.types
   :members:
+  :noindex:

noxfile.py

@@ -143,7 +143,7 @@ def docs(session):
     """Build the docs for this library."""
 
     session.install("-e", ".")
-    session.install("sphinx==2.4.4", "alabaster", "recommonmark")
+    session.install("sphinx", "alabaster", "recommonmark")
 
     shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
     session.run(