From 2a3a17ccad04f8d031078b85cef65e87e0cfb3ec Mon Sep 17 00:00:00 2001
From: Jake Valenzuela <5650707+jakeva@users.noreply.github.com>
Date: Tue, 31 Mar 2026 02:27:32 -0400
Subject: [PATCH] docs: simplify orphaned-stages rule description

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d4911d1..e031c61 100644
--- a/README.md
+++ b/README.md
@@ -234,9 +234,9 @@ Self-loops (`requisiteStageRefIds: ["1"]` on stage `"1"`) are also detected.
 
 ### `orphaned-stages` _(warning)_
 
-Flags stages that are completely disconnected from the pipeline graph: they have no prerequisites of their own (`requisiteStageRefIds` is empty) **and** no other stage depends on them. These are isolated islands that Spinnaker will run unconditionally in parallel with the rest of the pipeline, which is usually unintentional.
+Flags stages with no prerequisites and no dependents. These run unconditionally, independent of the rest of the pipeline.
 
-This rule does **not** flag valid terminal stages (stages at the end of a dependency chain that nothing else depends on) — those have prerequisites and are a normal part of pipeline design.
+Stages at the end of a dependency chain (prerequisites but no dependents) are not flagged.
 
 Stages with an empty `refId` are skipped (caught by `required-stage-fields` instead).