docs > update spacing + step instantiation example

Author: misscoded

docs/_steps/adding_editing_workflow_step.md

@@ -18,51 +18,52 @@ To learn more about opening configuration modals, [read the documentation](https
 </div>
 
 ```python
-def edit_handler(ack, step, configure):
-  ack()
+def edit(ack, step, configure):
+    ack()
 
-  blocks = [
-      {
-        "type": "input",
-        "block_id": "task_name_input",
-        "element": {
-          "type": "plain_text_input",
-          "action_id": "name",
-          "placeholder": {
-            "type": "plain_text",
-            "text": "Add a task name",
-          },
+    blocks = [
+        {
+            "type": "input",
+            "block_id": "task_name_input",
+            "element": {
+                "type": "plain_text_input",
+                "action_id": "name",
+                "placeholder": {
+                    "type": "plain_text",
+                    "text": "Add a task name",
+                },
+            },
+            "label": {
+                "type": "plain_text",
+                "text": "Task name",
+            },
         },
-        "label": {
-          "type": "plain_text",
-          "text": "Task name",
+        {
+            "type": "input",
+            "block_id": "task_description_input",
+            "element": {
+                "type": "plain_text_input",
+                "action_id": "description",
+                "placeholder": {
+                    "type": "plain_text",
+                    "text": "Add a task description",
+            },
+            },
+            "label": {
+                "type": "plain_text",
+                "text": "Task description",
+            },
         },
-      },
-      {
-        "type": "input",
-        "block_id": "task_description_input",
-        "element": {
-          "type": "plain_text_input",
-          "action_id": "description",
-          "placeholder": {
-            "type": "plain_text",
-            "text": "Add a task description",
-          },
-        },
-        "label": {
-          "type": "plain_text",
-          "text": "Task description",
-        },
-      },
     ]
 
     configure(blocks=blocks)
-  
-ws = WorkflowStep(callback_id="add_task", config={
-  "edit": edit_handler,
-  "save": save_handler,
-  "execute": execute_handler,
-})
+
+ws = WorkflowStep(
+    callback_id="add_task",
+    edit=edit,
+    save=save,
+    execute=execute,
+)
 
 app.step(ws)
 ```

docs/_steps/creating_workflow_step.md

@@ -26,15 +26,14 @@ app = App(
     signing_secret=os.environ.get("SLACK_SIGNING_SECRET")
 )
 
-# Define the step's configuration
-ws_config = {
-  "edit": edit_handler,
-  "save": save_handler,
-  "execute": execute_handler,
-}
-
 # Create a new WorkflowStep instance
-ws = WorkflowStep(callback_id="add_task", config=ws_config)
+ws = WorkflowStep(
+    callback_id="add_task",
+    edit=edit,
+    save=save,
+    execute=execute,
+)
 
+# Pass Step to set up listeners
 app.step(ws)
 ```

docs/_steps/executing_workflow_steps.md

@@ -16,16 +16,16 @@ Within the `execute` callback, your app must either call `complete()` to indicat
 </div>
 
 ```python
-def execute_handler(step, complete, fail):
+def execute(step, complete, fail):
     inputs = step["inputs"]
 
     outputs = {
-      "task_name": inputs["task_name"]["value"],
-      "task_description": inputs["task_description"]["value"],
+        "task_name": inputs["task_name"]["value"],
+        "task_description": inputs["task_description"]["value"],
     }
 
     error = {
-      "message": "Just testing step failure!"
+        "message": "Just testing step failure!"
     }
 
     # if everything was successful
@@ -34,11 +34,12 @@ def execute_handler(step, complete, fail):
     # if something went wrong
     fail(error=error)
 
-ws = WorkflowStep(callback_id="add_task", config={
-  "edit": edit_handler,
-  "save": save_handler,
-  "execute": execute_handler,
-})
+ws = WorkflowStep(
+    callback_id="add_task",
+    edit=edit,
+    save=save,
+    execute=execute,
+)
 
 app.step(ws)
 ```

docs/_steps/saving_workflow_step.md

@@ -21,42 +21,43 @@ To learn more about how to structure these parameters, [read the documentation](
 </div>
 
 ```python
-def save_handler(ack, view, update):
+def save(ack, view, update):
     ack()
 
-    values = view.state
+    values = view["state"]["values"]
     task_name = values["task_name_input"]["name"]
     task_description = values["task_description_input"]["description"]
 
     inputs = {
-      "task_name": { 
-        "value": task_name.value 
-      },
-      "task_description": { 
-        "value": task_description.value 
-      },
+        "task_name": { 
+            "value": task_name.value 
+        },
+        "task_description": { 
+            "value": task_description.value 
+        },
     }
 
     outputs = [
-      {
-        "type": "text",
-        "name": "task_name",
-        "label": "Task name",
-      },
-      {
-        "type": "text",
-        "name": "task_description",
-        "label": "Task description",
-      }
+        {
+            "type": "text",
+            "name": "task_name",
+            "label": "Task name",
+        },
+        {
+            "type": "text",
+            "name": "task_description",
+            "label": "Task description",
+        }
     ]
 
     update(inputs=inputs, outputs=outputs);
 
-ws = WorkflowStep(callback_id="add_task", config={
-  "edit": edit_handler,
-  "save": save_handler,
-  "execute": execute_handler,
-})
+ws = WorkflowStep(
+    callback_id="add_task",
+    edit=edit,
+    save=save,
+    execute=execute,
+)
 
 app.step(ws)
 ```