From b968ae0aa8a6bb5ccd5fabede0c6a4f25a5163cb Mon Sep 17 00:00:00 2001
From: John Spray <john@neon.tech>
Date: Wed, 15 May 2024 18:13:37 +0100
Subject: [PATCH] make a comment clearer

---
 pageserver/src/tenant/mgr.rs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pageserver/src/tenant/mgr.rs b/pageserver/src/tenant/mgr.rs
index fe00c8976d..bfe26311da 100644
--- a/pageserver/src/tenant/mgr.rs
+++ b/pageserver/src/tenant/mgr.rs
@@ -244,7 +244,9 @@ impl TenantsMap {
                     }
                 }
 
-                // Fall through: we didn't find an acceptable shard
+                // Fall through: we didn't find a slot that was in Attached state & matched our selector.  If
+                // we found one or more InProgress slot, indicate to caller that they should retry later.  Otherwise
+                // this requested shard simply isn't found.
                 if let Some(barrier) = any_in_progress {
                     ShardResolveResult::InProgress(barrier)
                 } else {