From 9d18ca9b69f59c9a82f344b89f4948884e1c2163 Mon Sep 17 00:00:00 2001
From: Matthias Fleschuetz
 <55826276+ntt-matthias-fleschuetz@users.noreply.github.com>
Date: Mon, 23 Feb 2026 20:13:52 +0100
Subject: [PATCH] docs: created section workflows

---
 docs/use/workflows.md                     |  4 ++--
 docs/use/{ => workflows}/preconditions.md |  4 ++--
 website/sidebars.js                       | 11 +++++++++--
 3 files changed, 13 insertions(+), 6 deletions(-)
 rename docs/use/{ => workflows}/preconditions.md (98%)

diff --git a/docs/use/workflows.md b/docs/use/workflows.md
index 1570141e..1031ff5e 100644
--- a/docs/use/workflows.md
+++ b/docs/use/workflows.md
@@ -31,7 +31,7 @@ Each step supports several optional execution control properties:
 | Property | Evaluated at | Purpose |
 |---|---|---|
 | `Condition` | Plan time | Include or skip the step based on request/intent data. |
-| `Preconditions` | Execution time (runtime) | Guard the step against stale or unsafe state immediately before it runs. See [Runtime Preconditions](preconditions.md). |
+| `Preconditions` | Execution time (runtime) | Guard the step against stale or unsafe state immediately before it runs. See [Runtime Preconditions](workflows/preconditions.md). |
 | `OnFailureSteps` | After failure (workflow-level) | Cleanup/rollback steps run after a primary step fails. |
 
 ---
@@ -175,6 +175,6 @@ For full definitions and reference, see:
 
 ## Next steps
 
-- Add runtime safety guards: [Runtime Preconditions](preconditions.md)
+- Add runtime safety guards: [Runtime Preconditions](workflows/preconditions.md)
 - Map external systems: [Providers](providers.md)
 - Review and export plans: [Plan Export](plan-export.md) (e.g. for CI systems)
diff --git a/docs/use/preconditions.md b/docs/use/workflows/preconditions.md
similarity index 98%
rename from docs/use/preconditions.md
rename to docs/use/workflows/preconditions.md
index a862c5f9..6f19dfa3 100644
--- a/docs/use/preconditions.md
+++ b/docs/use/workflows/preconditions.md
@@ -221,5 +221,5 @@ affect any other steps.
 
 ## Reference
 
-- [Steps reference](../reference/steps.md)
-- [Concepts: Plan → Execute separation](../about/concepts.md)
+- [Steps reference](../../reference/steps.md)
+- [Concepts: Plan → Execute separation](../../about/concepts.md)
diff --git a/website/sidebars.js b/website/sidebars.js
index 962285dd..1fd0815f 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -46,8 +46,15 @@ const sidebars = {
             'use/walkthrough/05-providers-authentication',
           ],
         },
-        'use/workflows',
-        'use/preconditions',
+        {
+          type: 'category',
+          label: 'Workflows',
+          collapsed: true,
+          items: [
+            'use/workflows',
+            'use/workflows/preconditions',
+          ],
+        },
         'use/providers',
         'use/plan-export',
       ],