Fix glossary and other 404s

The glossary was not being generated and there were a few other 404s
and warnings that are fixed.  Removed old TODO.  The glossary could
use some more work, but that TODO had become meaningless.

Change-Id: I7b6c0dc18c46d29a8edc85d22723acb3a25a2c26

doc/source/conf.py

@@ -53,9 +53,7 @@ pygments_style = 'sphinx'
 autodoc_member_order = "bysource"
 
 # Locations to exclude when looking for source files.
-# * Glossary is not included in any toctree, so it raised warnings, but it
+exclude_patterns = []
-#   is explicitly linked to from the top of users/index.rst.
-exclude_patterns = ["users/glossary.rst"]
 
 # -- Options for HTML output --------------------------------------------------
 

doc/source/contributors/index.rst

@@ -38,7 +38,7 @@ Development Environment
 
 The first step towards contributing code and documentation is to setup your
 development environment. We use a pretty standard setup, but it is fully
-documented in our `setup <setup>`_ section.
+documented in our `setup <setup.html>`_ section.
 
 .. toctree::
    :maxdepth: 2

doc/source/glossary.rst

@@ -1,5 +1,4 @@
-.. TODO(dtroyer): Resource needs further fleshing out, revise once the
+:orphan:
-..               object model in the SDK is finalized.
 
 Glossary
 ========

doc/source/index.rst

@@ -21,3 +21,6 @@ For Contributors
    :maxdepth: 2
 
    contributors/index
+
+For a listing of terms used throughout the SDK, including the names of
+projects and services supported by it, see the `Glossary <glossary.html>`_.

doc/source/users/index.rst

@@ -2,7 +2,7 @@ Getting started with the OpenStack SDK
 ======================================
 
 For a listing of terms used throughout the SDK, including the names of
-projects and services supported by it, see the `Glossary <glossary>`_.
+projects and services supported by it, see the `Glossary <../glossary.html>`_.
 
 Installation
 ------------

doc/source/users/resources/network/index.rst

@@ -5,7 +5,7 @@ Network Resources
    :maxdepth: 1
 
    v2/extension
-   v2/floatingip
+   v2/floating_ip
    v2/health_monitor
    v2/listener
    v2/load_balancer

openstack/resource.py

@@ -339,8 +339,8 @@ class Resource(collections.MutableMapping):
 
         :rtype: :class:`~openstack.resource.Resource` or the
                 appropriate subclass.
-         :raises: :exc:`ValueError` if ``value`` is not an instance of
+        :raises: :exc:`ValueError` if ``value`` is not an instance of
-                  this Resource type or a valid ``name``.
+                this Resource type or a valid ``name``.
         """
         return cls._from_attr(cls.name_attribute, value)