{"thread":{"id":"66801","subject":"[PATCH] partial-clone: document promisor remote fetch ordering","startedAt":"2026-11-07T15:04:33Z","lastAt":"2026-11-14T15:35:28Z","messageCount":7,"participants":["Hussain Sitamouwala","Junio C Hamano","Kaartic Sivaraam"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"557795","messageId":"20261107150433.17540-1-husainsitamuwala21@gmail.com","threadId":"66801","inReplyTo":null,"subject":"[PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Hussain Sitamouwala","fromEmail":"husainsitamuwala21@gmail.com","sentAt":"2026-11-07T15:04:33Z","receivedAt":"2026-11-07T15:04:33Z","isPatch":true,"sender":{"key":"husainsitamuwala21@gmail.com","avatar":null},"body":"Document that accepted promisor remotes are tried before other promisor remotes, and that Git falls back to the next remote when a fetch fails.\n\nSigned-off-by: Hussain Sitamouwala <husainsitamuwala21@gmail.com>\n---\n Documentation/technical/partial-clone.adoc | 4 +++-\n 1 file changed, 3 insertions(+), 1 deletion(-)\n\ndiff --git a/Documentation/technical/partial-clone.adoc b/Documentation/technical/partial-clone.adoc\nindex 18718a3840..9720b856ce 100644\n--- a/Documentation/technical/partial-clone.adoc\n+++ b/Documentation/technical/partial-clone.adoc\n@@ -195,7 +195,9 @@ cache servers for fetching missing blobs while continuing to do\n filtered `git-fetch` commands from the central server.\n \n When fetching objects, promisor remotes are tried one after the other\n-until all the objects have been fetched.\n+until all the objects have been fetched. Promisor remotes accepted from a\n+server are tried before other promisor remotes. If a fetch from a remote fails,\n+Git tries the remaining objects from the next remote.\n \n Remotes that are considered \"promisor\" remotes are those specified by\n the following configuration variables:\n-- \n2.53.0\n\n\n"},{"id":"557820","messageId":"xmqq5wy89rq6.fsf@gitster.g","threadId":"66801","inReplyTo":"20261107150433.17540-1-husainsitamuwala21@gmail.com","subject":"Re: [PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2026-11-07T22:55:29Z","receivedAt":"2026-11-07T22:55:29Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Hussain Sitamouwala <husainsitamuwala21@gmail.com> writes:\n\n> Document that accepted promisor remotes are tried before other promisor remotes, and that Git falls back to the next remote when a fetch fails.\n\nHussain, the above line is overly long.  Usual line-length\nlimitation rules for this mailing list applies (~70 columns).\n\nHussain, where did this documentation update come from?  What\nprompted you to make this update?  Is this documenting a\nlong-standing existing behaviour?  Is this trying to fill\ndocumentation gap left by more recent behaviour change?  Something\nelse?\n\nChristian, does the behaviour this patch documents the current one?\nHow does it relate to 8808e61fd3 (promisor-remote: try accepted\nremotes before others in get_direct(), 2026-04-07) which you did?\n\nIt seems there are multiple people sending messages with words like\n\"promisor\", \"fetch\", \"order\", and \"Outreachy\" on their \"Subject:\"\nfairly recently, but are you in charge of herding these folks, or is\nsomebody else helping them?  Without knowing if there is somebody\ncentral coordinating these that I can ask about, it is hard to tell\nif these people are making coherent effort to achieve something\nworthwhile, or if they are just randomly banging the door.\n\nThanks.\n\n> Signed-off-by: Hussain Sitamouwala <husainsitamuwala21@gmail.com>\n> ---\n>  Documentation/technical/partial-clone.adoc | 4 +++-\n>  1 file changed, 3 insertions(+), 1 deletion(-)\n>\n> diff --git a/Documentation/technical/partial-clone.adoc b/Documentation/technical/partial-clone.adoc\n> index 18718a3840..9720b856ce 100644\n> --- a/Documentation/technical/partial-clone.adoc\n> +++ b/Documentation/technical/partial-clone.adoc\n> @@ -195,7 +195,9 @@ cache servers for fetching missing blobs while continuing to do\n>  filtered `git-fetch` commands from the central server.\n>  \n>  When fetching objects, promisor remotes are tried one after the other\n> -until all the objects have been fetched.\n> +until all the objects have been fetched. Promisor remotes accepted from a\n> +server are tried before other promisor remotes. If a fetch from a remote fails,\n> +Git tries the remaining objects from the next remote.\n>  \n>  Remotes that are considered \"promisor\" remotes are those specified by\n>  the following configuration variables:\n\n"},{"id":"558389","messageId":"1c124d5d-790b-4d22-af22-c53573e6d2ec@gmail.com","threadId":"66801","inReplyTo":"xmqq5wy89rq6.fsf@gitster.g","subject":"Re: [PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Kaartic Sivaraam","fromEmail":"kaartic.sivaraam@gmail.com","sentAt":"2026-11-13T13:53:21Z","receivedAt":"2026-11-13T13:53:21Z","isPatch":true,"sender":{"key":"kaartic.sivaraam@gmail.com","avatar":"https://avatars.githubusercontent.com/u/12448084?v=4"},"body":"On 11/8/26 04:25, Junio C Hamano wrote:\n> Hussain Sitamouwala <husainsitamuwala21@gmail.com> writes:\n>  > It seems there are multiple people sending messages with words like\n> \"promisor\", \"fetch\", \"order\", and \"Outreachy\" on their \"Subject:\"\n> fairly recently, but are you in charge of herding these folks, or is\n> somebody else helping them?  Without knowing if there is somebody\n> central coordinating these that I can ask about, it is hard to tell\n> if these people are making coherent effort to achieve something\n> worthwhile, or if they are just randomly banging the door.\n> The patches surrounding promisor-remote are coming through because we had proposed the following project for this year's Outreachy round.\n\n  Implement promisor remote fetch ordering\n\n  When a Git repository is configured with multiple promisor remotes,\n  there’s currently no mechanism to specify or optimize the order in\n  which these remotes should be queried when fetching missing objects.\n  Different remotes may have different performance characteristics,\n  costs, or reliability, making fetch order an important consideration.\n\n  This project aims to implement a fetch ordering mechanism for multiple\n  promisor remotes. The order could be:\n\n    - Configured locally by the client\n    - Advertised by servers through the promisor-remote protocol\n\n  The key challenge is designing a flexible system that allows servers\n  to communicate their preferred fetch order to clients (to ensure\n  optimal performance and cost management).\n\nSee also: https://lore.kernel.org/git/CAP8UFD3kd=6QHp2oB+t+g-2D8bY-Oe5+_Vk+RJeaCa_xhxGrsA@mail.gmail.com/\n\nI have volunteered to mentor the same and Chrisitian has mentioned that he'll help with the project. Feel free to ping me too in case you see anything around this you need some help with.\n\nSorry for the late response. I just thought I'll fill in with the context in case it helps.\n\n-- \nSivaraam\n\n\n"},{"id":"558392","messageId":"CANRKfoCTtHrZ233nZyYQod6JJsNXve+Lofia7=8pnum6oEPF0g@mail.gmail.com","threadId":"66801","inReplyTo":"1c124d5d-790b-4d22-af22-c53573e6d2ec@gmail.com","subject":"Re: [PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Hussain Sitamouwala","fromEmail":"husainsitamuwala21@gmail.com","sentAt":"2026-11-13T14:23:15Z","receivedAt":"2026-11-13T14:23:15Z","isPatch":true,"sender":{"key":"husainsitamuwala21@gmail.com","avatar":null},"body":"Hi Kaartic,\n\nThank you for the context on the project and for the offer to help,\nI appreciate it.\n\nFor the record, the discussion on this patch continued in the v2\nthread, and the final version (v3) has been queued as\nhs/doc-promisor-fetch-order. The commit message explains that it\ndocuments the ordering introduced by 8808e61fd3.\n\nThanks,\nHussain\n\n"},{"id":"558399","messageId":"CANRKfoBw-+J5Dhb0ONGdWRU8wv6v7TBzGxQi2nmaLrDJbB_Prg@mail.gmail.com","threadId":"66801","inReplyTo":"CANRKfoCTtHrZ233nZyYQod6JJsNXve+Lofia7=8pnum6oEPF0g@mail.gmail.com","subject":"Re: [PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Hussain Sitamouwala","fromEmail":"husainsitamuwala21@gmail.com","sentAt":"2026-11-13T14:37:44Z","receivedAt":"2026-11-13T14:37:44Z","isPatch":true,"sender":{"key":"husainsitamuwala21@gmail.com","avatar":null},"body":"Hi Kaartic, Junio,\n\nJunio, thank you for the review and for queueing v3. The comments on\nthe redundant sentence and on threading were useful.\n\nReading promisor_remote_get_direct() and try_promisor_remotes() for\nthis patch made me want to keep working on \"Implement promisor remote\nfetch ordering\".\n\nKaartic, a question: from the project description I see two parts,\na client-side way to configure the order and the server advertising\nits preferred order. My understanding is that the client-side part is\nthe smaller first step, since it does not change the protocol, but I\nmay be missing context. Would you suggest starting there?\n\nBefore writing any code, I will read the earlier list discussion\naround 8808e61fd3 and the promisor-remote capability, so I do not\nask about things that were already settled.\n\nThanks,\nHussain\n\n"},{"id":"558458","messageId":"f3b571fc-d39c-442b-b1d4-cac78daa995f@gmail.com","threadId":"66801","inReplyTo":"CANRKfoCTtHrZ233nZyYQod6JJsNXve+Lofia7=8pnum6oEPF0g@mail.gmail.com","subject":"Re: [PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Kaartic Sivaraam","fromEmail":"kaartic.sivaraam@gmail.com","sentAt":"2026-11-14T15:32:50Z","receivedAt":"2026-11-14T15:32:50Z","isPatch":true,"sender":{"key":"kaartic.sivaraam@gmail.com","avatar":"https://avatars.githubusercontent.com/u/12448084?v=4"},"body":"On 11/13/26 19:53, Hussain Sitamouwala wrote:\n> Hi Kaartic,\n> > Thank you for the context on the project and for the offer to help,\n> I appreciate it.\n> > For the record, the discussion on this patch continued in the v2\n> thread, and the final version (v3) has been queued as\n> hs/doc-promisor-fetch-order. The commit message explains that it\n> documents the ordering introduced by 8808e61fd3.\n> Sorry if it wasn't clear. I actually intended that reply to Junio.\n\nI am aware that v3 has been queued. Thank you for the context, though. Kudos on getting it queued!\n\n-- \nSivaraam\n\n\n"},{"id":"558459","messageId":"df581c51-97d1-41ce-8e7f-030cff8446d6@gmail.com","threadId":"66801","inReplyTo":"CANRKfoBw-+J5Dhb0ONGdWRU8wv6v7TBzGxQi2nmaLrDJbB_Prg@mail.gmail.com","subject":"Re: [PATCH] partial-clone: document promisor remote fetch ordering","fromName":"Kaartic Sivaraam","fromEmail":"kaartic.sivaraam@gmail.com","sentAt":"2026-11-14T15:35:28Z","receivedAt":"2026-11-14T15:35:28Z","isPatch":true,"sender":{"key":"kaartic.sivaraam@gmail.com","avatar":"https://avatars.githubusercontent.com/u/12448084?v=4"},"body":"On 11/13/26 20:07, Hussain Sitamouwala wrote:\n> > Kaartic, a question: from the project description I see two parts,\n> a client-side way to configure the order and the server advertising\n> its preferred order. My understanding is that the client-side part is\n> the smaller first step, since it does not change the protocol, but I\n> may be missing context. Would you suggest starting there?\n>\n\nIt is indeed good to start with client-side but considering also that the server-side part needs to be introduced later.\n\nIn any case, this is something to be discussed post the Outreachy results are out, I think.\n\n-- \nSivaraam\n\n\n"}]}