Rename anyDirectTasks to firstDirectTask for clarity and update related documentation

Author: EdmondDantes

basic.md

@@ -944,7 +944,7 @@ Caught exception: Error
 #### Task Race
 
 Sometimes it's necessary to get the result of the fastest task from a set.  
-The **`Scope::anyDirectTasks`** method returns a trigger 
+The **`Scope::firstDirectTask`** method returns a trigger 
 that fires as soon as at least one of the direct tasks in the **Scope** is completed.
 
 **Example:**
@@ -960,7 +960,7 @@ function fetchDataFromApi(string ...$apiHosts): string
 
         // Get the result of the fastest task
         // and cancel all other tasks
-        return await $scope->anyDirectTasks();
+        return await $scope->firstDirectTask();
     };
 }
 

diagrams/decision-tree.puml

@@ -22,7 +22,7 @@ spawn use($some): void {
 **[#87CEEB] You want to wait with cancellation?
 ***[#lightgreen] Use await until: await $coroutine until $cancellation
 **[#87CEEB] Do you want to wait for at least one task (race)?
-***[#lightgreen] Use await + Scope::anyDirectTasks()
+***[#lightgreen] Use await + Scope::firstDirectTask()
 *[#lightblue] Do you need to cancel tasks?
 **[#87CEEB] Do you want to cancel a single coroutine?
 ***[#lightgreen] Use Coroutine::cancel()

diagrams/decision-tree.svg

@@ -27,7 +27,7 @@ async inherit $scope {
 **[#FFD700] Waiting for direct child tasks
 ***[#lightgreen] Scope::directTasks()
 **[#FFD700] Waiting for first direct child tasks (race)
-***[#lightgreen] Scope::anyDirectTasks()
+***[#lightgreen] Scope::firstDirectTask()
 **[#FFD700] Waiting with cancellation
 ***[#lightgreen]: await + until
 

diagrams/mind-map.puml

@@ -26,7 +26,7 @@ public function cancel(?CancellationException $cancellationException = null): vo
 
     public function directTasks(): Awaitable {}
 
-    public function anyDirectTasks(): Awaitable {}
+    public function firstDirectTask(): Awaitable {}
 
     public function allTasks(): Awaitable {}