docs: split promo step reference into multiple pages

Signed-off-by: Hidde Beydals <[email protected]>
akuity · Jan 14, 2025 · 6e70bc6 · 6e70bc6
1 parent 09cb991
commit 6e70bc6
Show file tree

Hide file tree

Showing 26 changed files with 1,663 additions and 1,720 deletions.
diff --git a/docs/docs/20-quickstart.md b/docs/docs/20-quickstart.md
@@ -873,8 +873,8 @@ the previous section.
     :::note
     Although this example does not demonstrate it, it is also possible to verify
     the `Freight` in a `Stage` using user-defined processes. See the
-    [relevant section](./15-concepts.md#verifications) of the concepts page to
-    learn more.
+    [relevant section](./30-how-to-guides/14-working-with-stages.md#verifications)
+    of the concepts page to learn more.
     :::
 
 ## Behind the Scenes

diff --git a/docs/docs/30-how-to-guides/14-working-with-stages.md b/docs/docs/30-how-to-guides/14-working-with-stages.md
@@ -219,7 +219,7 @@ promotionTemplate:
 
 :::info
 For complete documentation of all Kargo's built-in promotion steps, refer
-to the [Promotion Steps Reference](../35-references/10-promotion-steps.md).
+to the [Promotion Steps Reference](../35-references/10-promotion-steps/index.md).
 :::
 
 ### Verifications

diff --git a/docs/docs/30-how-to-guides/25-argo-cd-integration.md b/docs/docs/30-how-to-guides/25-argo-cd-integration.md
@@ -23,7 +23,7 @@ In the course of orchestrating the transition of an application instance
 from one state to another, it is common for Kargo to updated Argo CD
 `Application` resources in some way. Such updates are enabled through the
 use of the
-[`argocd-update` promotion step](../35-references/10-promotion-steps.md#argocd-update).
+[`argocd-update` promotion step](../35-references/10-promotion-steps/50-argocd-update.md).
 Often, these updates entail little more than modifying an `Application`'s 
 `operation` field to force the `Application` to be synced to recently
 updated desired state.