Address review feedback (tweak some docstrings).

cylc/flow/network/resolvers.py

@@ -715,9 +715,12 @@ def set_graph_window_extent(self, n_edge_distance):
     def force_spawn_children(self, tasks, outputs, flow_num):
         """Spawn children of given task outputs.
 
+        User-facing method name: set_outputs.
+
         Args:
             tasks (list): List of identifiers, see `task globs`
             outputs (list): List of outputs to spawn on
+            flow_num (int): Flow number to attribute the outputs.
 
         Returns:
             tuple: (outcome, message)

cylc/flow/scheduler.py

@@ -1845,7 +1845,11 @@ def command_force_trigger_tasks(self, items, reflow, flow_descr):
         return self.pool.force_trigger_tasks(items, reflow, flow_descr)
 
     def command_force_spawn_children(self, items, outputs, flow_num):
-        """Force spawn task successors."""
+        """Force spawn task successors.
+
+        User-facing method name: set_outputs.
+
+        """
         return self.pool.force_spawn_children(items, outputs, flow_num)
 
     def _update_profile_info(self, category, amount, amount_format="%s"):

cylc/flow/task_pool.py

@@ -1388,7 +1388,11 @@ def match_taskdefs(
         return n_warnings, task_items
 
     def force_spawn_children(self, items, outputs, flow_num):
-        """Spawn downstream children of given task outputs on user command."""
+        """Spawn downstream children of given task outputs on user command.
+
+        User-facing method name: set_outputs.
+
+        """
         n_warnings, task_items = self.match_taskdefs(items)
         for (_, point), taskdef in sorted(task_items.items()):
             # This the upstream target task: