spacelift-io · ottopilotto · Nov 15, 2023 · Nov 13, 2023 · Nov 13, 2023 · Nov 14, 2023
diff --git a/docs/assets/screenshots/context/add_autoattachment_label.png b/docs/assets/screenshots/context/add_autoattachment_label.png
diff --git a/docs/assets/screenshots/context/add_mounted_file_a.png b/docs/assets/screenshots/context/add_mounted_file_a.png
diff --git a/docs/assets/screenshots/context/add_mounted_file_b.png b/docs/assets/screenshots/context/add_mounted_file_b.png
diff --git a/docs/assets/screenshots/context/attach_context_to_stack.png b/docs/assets/screenshots/context/attach_context_to_stack.png
diff --git a/docs/assets/screenshots/context/attached_context_envs.png b/docs/assets/screenshots/context/attached_context_envs.png
diff --git a/docs/assets/screenshots/context/context_envs_in_stack_view.png b/docs/assets/screenshots/context/context_envs_in_stack_view.png
diff --git a/docs/assets/screenshots/context/context_hooks_reordering.gif b/docs/assets/screenshots/context/context_hooks_reordering.gif
diff --git a/docs/assets/screenshots/context/contexts_list.png b/docs/assets/screenshots/context/contexts_list.png
diff --git a/docs/assets/screenshots/context/contexts_list_in_stack_after_attaching.png b/docs/assets/screenshots/context/contexts_list_in_stack_after_attaching.png
diff --git a/docs/assets/screenshots/context/contexts_list_in_stack_view.png b/docs/assets/screenshots/context/contexts_list_in_stack_view.png
diff --git a/docs/assets/screenshots/context/create_context_button.png b/docs/assets/screenshots/context/create_context_button.png
diff --git a/docs/assets/screenshots/context/create_stack_auto_attached_stack.png b/docs/assets/screenshots/context/create_stack_auto_attached_stack.png
diff --git a/docs/assets/screenshots/context/creation_form_step_1.png b/docs/assets/screenshots/context/creation_form_step_1.png
diff --git a/docs/assets/screenshots/context/creation_form_step_2.png b/docs/assets/screenshots/context/creation_form_step_2.png
diff --git a/docs/assets/screenshots/context/creation_form_step_2a.png b/docs/assets/screenshots/context/creation_form_step_2a.png
diff --git a/docs/assets/screenshots/context/creation_form_step_2b.png b/docs/assets/screenshots/context/creation_form_step_2b.png
diff --git a/docs/assets/screenshots/context/creation_form_step_4.png b/docs/assets/screenshots/context/creation_form_step_4.png
diff --git a/docs/assets/screenshots/context/delete_context_confirmation.png b/docs/assets/screenshots/context/delete_context_confirmation.png
diff --git a/docs/assets/screenshots/context/delete_from_context_view_option.png b/docs/assets/screenshots/context/delete_from_context_view_option.png
diff --git a/docs/assets/screenshots/context/detach_context.png b/docs/assets/screenshots/context/detach_context.png
diff --git a/docs/assets/screenshots/context/edit_context_details_drawer.png b/docs/assets/screenshots/context/edit_context_details_drawer.png
diff --git a/docs/assets/screenshots/context/edit_env_var.png b/docs/assets/screenshots/context/edit_env_var.png
diff --git a/docs/assets/screenshots/context/edit_env_var_option.png b/docs/assets/screenshots/context/edit_env_var_option.png
diff --git a/docs/assets/screenshots/context/edit_from_context_view.png b/docs/assets/screenshots/context/edit_from_context_view.png
diff --git a/docs/assets/screenshots/context/edit_mounted_file.png b/docs/assets/screenshots/context/edit_mounted_file.png
diff --git a/docs/assets/screenshots/context/env_vars.png b/docs/assets/screenshots/context/env_vars.png
diff --git a/docs/assets/screenshots/context/hooks_list.png b/docs/assets/screenshots/context/hooks_list.png
diff --git a/docs/assets/screenshots/context/stack_hooks.png b/docs/assets/screenshots/context/stack_hooks.png
diff --git a/docs/assets/screenshots/context/stack_init_phase_hooks.png b/docs/assets/screenshots/context/stack_init_phase_hooks.png
diff --git a/docs/assets/screenshots/context/stack_settings_matching_autoattachment_label.png b/docs/assets/screenshots/context/stack_settings_matching_autoattachment_label.png
diff --git a/docs/concepts/configuration/context.md b/docs/concepts/configuration/context.md
diff --git a/docs/concepts/stack/stack-settings.md b/docs/concepts/stack/stack-settings.md
@@ -59,9 +59,15 @@ These commands may serve one of two general purposes - either to make some modif
 !!! info
     If any of the "before" hooks fail (non-zero exit code), the relevant phase is not executed. If the phase itself fails, none of the "after" hooks get executed.
 
+{% if is_saas() %}
+The workflow can be customized either using our [Terraform provider](https://registry.terraform.io/providers/spacelift-io/spacelift/latest/docs/resources/stack){: rel="nofollow"} or in the GUI. The GUI has a very nice editor that allows you to customize commands before and after each phase. You will be able to add and remove commands, reorder them using _drag and drop_ and edit them in-line. Note how the commands that precede the customized phase are the "before" hooks (`ps aux` and `ls` in the example below), and the ones that go after it are the "after" hooks (`ls -la .terraform`):
+
+![](<../../assets/screenshots/context/stack_init_phase_hooks.png>)
+{% else %}
 The workflow can be customized either using our [Terraform provider](https://registry.terraform.io/providers/spacelift-io/spacelift/latest/docs/resources/stack){: rel="nofollow"} or in the GUI. The GUI has a very nice editor that allows you to select the phase you want to customize and add commands before and after each phase. You will be able to add and remove commands, reorder them using _drag and drop_ and edit them in-line. Note how the commands that precede the customized phase are the "before" hooks (`ps aux` and `ls` in the example below), and the ones that go after it are the "after" hooks (`ls -la .terraform`):
 
 ![](<../../assets/screenshots/Mouse_Highlight_Overlay (7).png>)
+{% endif %}
 
 Perhaps worth noting is the fact that these commands run in the same shell session as the phase itself. So the phase will have access to any shell variables exported by the preceding scripts.
 
@@ -70,14 +76,35 @@ Environment variables are preserved from one phase to the next.
 !!! info
     These scripts can be overridden by the [runtime configuration](../configuration/runtime-configuration/README.md#before_init-scripts) specified in the `.spacelift/config.yml` file.
 
+{% if is_saas() %}
+
+#### Note on hook ordering
+
+Hooks added to stacks and contexts attached to them follow distinct ordering principles. Stack hooks are organized through a drag-and-drop mechanism, while context hooks adhere to prioritization based on context priority. Additionally, auto-attached contexts are arranged alphabetically.
+
+In the before phase, the priority of stack hooks is secondary to that of context hooks. Conversely, in the after phase, this priority order is reversed.
+
+Hooks from both manually and auto-attached contexts can only be edited from their respective views. Specifically, in the before phase:
+
+- Hooks from manually attached contexts take precedence and are arranged according to context attachment priority.
+- Subsequently, hooks from auto-attached contexts, ordered alphabetically.
+- Stack hooks occupy the final position in the sequence.
+
+For the after phase, the ordering is reversed.
+{% endif %}
+
 ### Runtime commands
 
 Spacelift can handle special commands to change the workflow behavior.
 Runtime commands use the echo command in a specific format.
 
 You could use those commands in any lifecycle step of the workflow.
 
+{% if is_saas() %}
+![stack_runtime_command](../../assets/screenshots/context/stack_hooks.png)
+{% else %}
 ![stack_runtime_command](../../assets/screenshots/stack_runtime_command.png)
+{% endif %}
 
 ```bash
 echo "::command arg1 arg2"