Merge "Add missing suffix-related docstrings"

placement/objects/allocation_candidate.py

@@ -462,6 +462,8 @@ def _allocation_request_for_provider(ctx, requested_resources, provider,
                                 being requested for that resource class
     :param provider: ResourceProvider object representing the provider of the
                      resources.
+    :param suffix: The suffix of the RequestGroup these resources are
+                   satisfying.
     """
     resource_requests = [
         AllocationRequestResource(

placement/tests/functional/db/test_allocation_candidates.py

@@ -902,6 +902,9 @@ class AllocationCandidatesTestCase(tb.PlacementDbBaseTestCase):
                 ...
              ]
         :param candidates: The result from AllocationCandidates.get_by_requests
+        :param expect_suffix: If True, validate the RequestGroup suffix in the
+                              results, found as a 4th member of the tuple
+                              described above.
         """
         # Extract/convert allocation requests from candidates
         observed = []