Clarify the function of wait_for_downstream

airflow/models.py

@@ -962,11 +962,11 @@ class BaseOperator(object):
         sequentially while relying on the previous task's schedule to
         succeed. The task instance for the start_date is allowed to run.
     :type depends_on_past: bool
-    :param wait_for_downstream: when set to true, the task instances
+    :param wait_for_downstream: when set to true, an instance of task
-        of task X will wait for the dependencies of the previous instance
+        X will wait for the dependents of the previous instance of task X
-        of task X to finish before it moves on the to next schedule.
+        to finish successfully before it runs. This is useful if the
-        This is useful if the different instances of a task X alter
+        different instances of a task X alter the same asset, and this asset
-        the same asset, and this asset is used by the dependencies of task X.
+        is used by the dependencies of task X.
     :type wait_for_downstream: bool
     :param queue: which queue to target when running this job. Not
         all executors implement queue management, the CeleryExecutor