Repository: googleapis/google-cloud-python

Issue:
Redis: 'docs' session breaks CI.
See [this Kokoro failure](https://source.cloud.google.com/results/invocations/5fd6c04a-0be0-41be-8c84-330157b125eb/targets/cloud-devrel%2Fclient-libraries%2Fgoogle-cloud-python%2Fpresubmit%2Fredis/log):

```
Running session docs
Creating virtualenv using python3.7 in /tmpfs/src/github/google-cloud-python/redis/.nox/docs
pip install -e .
pip install sphinx alabaster recommonmark
sphinx-build -W -T -N -b html -d docs/_build/doctrees/ docs/ docs/_build/html/
Running Sphinx v2.0.1
making output directory... done
/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/events.py:76: RemovedInSphinx30Warning: autodoc_default_flags is now deprecated. Please use autodoc_default_options instead.
  results.append(callback(*args))
[autosummary] generating autosummary for: gapic/v1/api.rst, gapic/v1/types.rst, gapic/v1beta1/api.rst, gapic/v1beta1/types.rst, index.rst
loading intersphinx inventory from http://python.readthedocs.org/en/latest/objects.inv...
intersphinx inventory has moved: http://python.readthedocs.org/en/latest/objects.inv -> https://python.readthedocs.io/en/latest/objects.inv
loading intersphinx inventory from https://gax-python.readthedocs.org/en/latest/objects.inv...
intersphinx inventory has moved: https://gax-python.readthedocs.org/en/latest/objects.inv -> https://gax-python.readthedocs.io/en/latest/objects.inv
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 5 source files that are out of date
updating environment: 5 added, 0 changed, 0 removed
reading sources... [ 20%] gapic/v1/api
reading sources... [ 40%] gapic/v1/types
reading sources... [ 60%] gapic/v1beta1/api
reading sources... [ 80%] gapic/v1beta1/types
reading sources... [100%] index
Traceback (most recent call last):
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/cmd/build.py", line 284, in build_main
    app.build(args.force_all, filenames)
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/application.py", line 337, in build
    self.builder.build_update()
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/builders/__init__.py", line 326, in build_update
    len(to_build))
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/builders/__init__.py", line 339, in build
    updated_docnames = set(self.read())
  File "/usr/local/lib/python3.7/contextlib.py", line 119, in __exit__
    next(self.gen)
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/util/logging.py", line 230, in pending_warnings
    memhandler.flushTo(logger)
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/util/logging.py", line 193, in flushTo
    logger.handle(record)
  File "/usr/local/lib/python3.7/logging/__init__.py", line 1477, in handle
    self.callHandlers(record)
  File "/usr/local/lib/python3.7/logging/__init__.py", line 1539, in callHandlers
    hdlr.handle(record)
  File "/usr/local/lib/python3.7/logging/__init__.py", line 849, in handle
    rv = self.filter(record)
  File "/usr/local/lib/python3.7/logging/__init__.py", line 711, in filter
    result = f.filter(record)
  File "/tmpfs/src/github/google-cloud-python/redis/.nox/docs/lib/python3.7/site-packages/sphinx/util/logging.py", line 426, in filter
    raise SphinxWarning(location + ":" + message)
sphinx.errors.SphinxWarning: /tmpfs/src/github/google-cloud-python/redis/docs/index.rst:1:Problems with "include" directive path:
InputError: [Errno 2] No such file or directory: 'redis/README.rst'.
```


Discussion:

Resolving patch:
diff --git a/redis/docs/conf.py b/redis/docs/conf.py
--- a/redis/docs/conf.py
+++ b/redis/docs/conf.py
@@ -44,13 +44,18 @@
 autodoc_default_flags = ["members"]
 autosummary_generate = True
 
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 # source_suffix = ['.rst', '.md']
-source_suffix = ".rst"
+source_suffix = [".rst", "md"]
 
 # The encoding of source files.
 # source_encoding = 'utf-8-sig'
@@ -116,6 +121,7 @@
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
 
+
 # -- Options for HTML output ----------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
@@ -125,7 +131,15 @@
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-# html_theme_options = {}
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
@@ -214,6 +228,18 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = "google-cloud-redis-doc"
 
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
 # -- Options for LaTeX output ---------------------------------------------
 
 latex_elements = {
@@ -265,7 +291,13 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    (master_doc, "google-cloud-redis", u"google-cloud-redis Documentation", [author], 1)
+    (
+        master_doc,
+        "google-cloud-automl",
+        u"google-cloud-automl Documentation",
+        [author],
+        1,
+    )
 ]
 
 # If true, show URL addresses after external links.
@@ -300,10 +332,21 @@
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 # texinfo_no_detailmenu = False
 
+
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
     "python": ("http://python.readthedocs.org/en/latest/", None),
     "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": (
+        "https://googleapis.github.io/google-cloud-python/latest",
+        None,
+    ),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("http://docs.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
 }
 
 # Napoleon settings


Test patch: