Merge "Clarify pool scheduler filter documentation"

designate/scheduler/filters/fallback_filter.py

@@ -20,8 +20,8 @@ CONF = designate.conf.CONF
 
 
 class FallbackFilter(base.Filter):
-    """If there is no zones available to schedule to, this filter will insert
-    the default_pool_id.
+    """During the filtering process, if there are no matching pools available
+    to schedule to, this filter will insert the default_pool_id.
 
     .. note::
 

doc/source/admin/multiple-pools.rst

@@ -291,9 +291,8 @@ your own.
      - ``random``--if multiple pools have been specified, randomly assigns the
        zone to a pool.
 
-     - ``in_doubt_default_pool``--if none of the specified pools are
-       available, and the default pool has not been specified, assigns the
-       zone to the default pool.
+     - ``in_doubt_default_pool``--if multiple pools match the filters and
+       the default pool is among them, selects only the default pool.
 
 #. Add the filters that you want the scheduler to use in the
    ``service:central`` section of the ``designate.conf`` file. See