[Outreachy PATCH] doc: clarify promisor remote fetch ordering
From fe5f35b00eafa1eb2756178445d3e88c4e9d6787 Mon Sep 17 00:00:00 2001
From: Edson <edsonwasswa54@gmail.com>
Date: Thu, 22 Oct 2026 13:09:21 +0300
Subject: [PATCH] doc: clarify promisor remote fetch ordering
Signed-off-by: Edson <edsonwasswa54@gmail.com>
---
Documentation/technical/partial-clone.adoc | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Documentation/technical/partial-clone.adoc
b/Documentation/technical/partial-clone.adoc
index 18718a3840..a1104930fb 100644
--- a/Documentation/technical/partial-clone.adoc
+++ b/Documentation/technical/partial-clone.adoc
@@ -196,6 +196,11 @@ filtered `git-fetch` commands from the central server.
When fetching objects, promisor remotes are tried one after the other
until all the objects have been fetched.
+When a server advertises promisor remotes via the protocol v2
+"promisor-remote" capability and the client accepts them (see
+linkgit:gitprotocol-v2[5]), those accepted remotes are tried first.
+After trying the accepted remotes, Git then tries the other configured
+promisor remotes as described below.
Remotes that are considered "promisor" remotes are those specified by
the following configuration variables:
--
2.53.0