Merge pull request #56 from jlowin/tasks

Fix subtask docs

Author: jlowin

docs/concepts/tasks.mdx

@@ -192,29 +192,38 @@ data_analysis_task = Task(
 ```
 
 ### Subtasks
+Subtasks allow you to break down complex tasks into smaller steps and manage the workflow more effectively. Subtasks can be defined either by creating tasks with the context of another task, or by passing a task as a `parent` parameter to the subtask. 
 
-Subtasks can be defined using the `subtasks` property of the `Task` class. By organizing tasks into subtasks, you can break down complex tasks into smaller, more focused units of work.
+<CodeGroup>
+```python Context manager
+from controlflow import Task
 
-```python
-data_processing_task = Task(
-    objective="Process the raw data and prepare it for analysis",
-    subtasks=[
-        Task(
-            objective="Load the raw data from the source",
-            result_type=pd.DataFrame,
-        ),
-        Task(
-            objective="Clean and preprocess the loaded data",
-            result_type=pd.DataFrame,
-        ),
-        Task(
-            objective="Perform feature engineering on the preprocessed data",
-            result_type=pd.DataFrame,
-        ),
-    ],
-    result_type=pd.DataFrame,
+with Task(objective="Prepare data", result_type=list) as parent_task:
+    child_task_1 = Task('Load data from the source', result_type=list)
+    child_task_2 = Task(
+        'Clean and preprocess the loaded data', 
+        result_type=list, 
+        context=dict(data=child_task_1),
+    )
+```
+
+```python Parent parameter
+from controlflow import Task
+
+parent_task = Task(objective="Prepare data", result_type=list)
+child_task_1 = Task(
+    'Load data from the source', 
+    result_type=list, 
+    parent=parent_task,
+)
+child_task_2 = Task(
+    'Clean and preprocess the loaded data', 
+    result_type=list, 
+    context=dict(data=child_task_1),
+    parent=parent_task,
 )
 ```
+</CodeGroup>
 
 ## Executing Tasks
 
@@ -223,7 +232,6 @@ Tasks can be executed using the `run()` method, which coordinates the execution
 ```python
 data_processing_task = Task(
     objective="Process the raw data and prepare it for analysis",
-    subtasks=[...],
     result_type=pd.DataFrame,
 )
 

docs/reference/task-class.mdx

@@ -70,10 +70,8 @@ Dependencies are defined as a list of `Task` instances. When a task is executed,
 By specifying dependencies, you can create a structured workflow where tasks are executed in a specific order based on their dependencies. This helps ensure that tasks have access to the necessary data or results from previous tasks before they start.
 </ParamField>
 
-<ParamField path="subtasks" type="list[Task]">
-The `subtasks` property allows you to define a hierarchical structure of tasks by specifying subtasks for a given task. Subtasks are smaller, more focused tasks that contribute to the completion of the parent task.
+<ParamField path="parent" type="Optional[Task]">
+The `parent` property allows you to specify a parent task for the current task. It establishes a hierarchical relationship between tasks, where the parent task is responsible for managing and coordinating the execution of its child tasks.
 
-Subtasks are defined as a list of `Task` instances. When a task is executed, its subtasks are also executed as part of the overall task execution process. The parent task is considered complete only when all its subtasks have been successfully completed.
-
-By organizing tasks into subtasks, you can break down complex tasks into smaller, more manageable units of work. This promotes modularity, reusability, and easier maintenance of the task hierarchy.
+By organizing tasks into subtasks, you can break down complex tasks into smaller, more manageable units of work. This promotes modularity, reusability, and easier maintenance of the task hierarchy. When a task is created with a parent task, it automatically becomes a subtask of the parent task. The parent task is considered complete only when all its subtasks have been successfully completed.
 </ParamField>