Clean up some errant doc warnings/errors

This change cleans up a couple of minor doc warnings that don't usually
get caught. I'm making this small change now so that I can turn on
warnings_as_errors in the enforcer script.

Change-Id: Ib0100116a4f7a38ad882d20a56ae99d15d49766a

doc/source/users/index.rst

@@ -81,6 +81,7 @@ but listed below are the ones provided by this SDK by default.
    Image v1 <proxies/image_v1>
    Image v2 <proxies/image_v2>
    Key Manager <proxies/key_manager>
+   Load Balancer <proxies/load_balancer_v2>
    Message v1 <proxies/message_v1>
    Message v2 <proxies/message_v2>
    Network <proxies/network>

doc/source/users/proxies/telemetry.rst

@@ -6,7 +6,7 @@ Telemetry API
 
 For details on how to use telemetry, see :doc:`/users/guides/telemetry`
 
-.. automethod:: openstack.telemetry.v2._proxy
+.. automodule:: openstack.telemetry.v2._proxy
 
 The Telemetry Class
 -------------------

doc/source/users/proxies/workflow.rst

@@ -1,8 +1,6 @@
 Workflow API
 ============
 
-For details on how to use workflow, see :doc:`/users/guides/workflow`
-
 .. automodule:: openstack.workflow.v2._proxy
 
 The Workflow Class

openstack/cluster/v1/_proxy.py

@@ -1051,7 +1051,8 @@ class Proxy(proxy2.BaseProxy):
                          The resource must have a ``status`` attribute.
         :type resource: A :class:`~openstack.resource2.Resource` object.
         :param status: Desired status.
-        :param list failures: Statuses that would be interpreted as failures.
+        :param failures: Statuses that would be interpreted as failures.
+        :type failures: :py:class:`list`
         :param interval: Number of seconds to wait before to consecutive
                          checks. Default to 2.
         :param wait: Maximum number of seconds to wait before the change.