(docs) Add more context to the WorkingDirectory and change Api to API

core/src/main/java/io/kestra/core/tasks/flows/WorkingDirectory.java

@@ -29,10 +29,13 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Run tasks sequentially sharing the same working directory",
-    description = "By default, Kestra will launch each task on a fresh working directory and on a new worker instance.\n" +
-        "This task will run sequentially keeping the same filesystem allowing reuse of previous task files on next tasks and" +
-        "keeping track of execution time for each tasks. It can only runs runnable tasks as tasks will be run immediately on the worker"
+    title = "Run tasks sequentially in the same working directory",
+    description = "Tasks are stateless by default. Kestra will launch each task within a temporary working directory on a Worker.\n" +
+        "The `WorkingDirectory` task allows reusing the same file system's working directory across multiple tasks \n" +
+        "so that multiple sequential tasks can use output files from previous tasks without having to use the `{{outputs.taskId.outputName}}` syntax." +
+        "Note that the `WorkingDirectory` only works with runnable tasks because those tasks are executed directly on the Worker." +
+        "This means that using flowable tasks such as the `Parallel` task within the `WorkingDirectory` task will not work." +
+        "The `WorkingDirectory` task requires Kestra>=0.9.0."
 )
 @Plugin(
     examples = {

ui/src/translations.json

@@ -451,7 +451,7 @@
       }
     },
     "title": "Title",
-    "api": "Api",
+    "api": "API",
     "expand error": "Expand only failed task",
     "expand all": "Expand all",
     "collapse all": "Collapse all",
@@ -915,7 +915,7 @@
       }
     },
     "title": "Titre",
-    "api": "Api",
+    "api": "API",
     "expand error": "Afficher uniquement les erreurs",
     "expand all": "Afficher tout",
     "collapse all": "Masquer tout",