{"thread":{"id":"65948","subject":"[PATCH] SubmittingPatches: abandoning a series","startedAt":"2026-07-08T01:20:56Z","lastAt":"2026-07-08T18:23:32Z","messageCount":3,"participants":["Junio C Hamano","Michael Montalbo"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"547419","messageId":"xmqqzf02xonc.fsf@gitster.g","threadId":"65948","inReplyTo":null,"subject":"[PATCH] SubmittingPatches: abandoning a series","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2026-07-08T01:20:55Z","receivedAt":"2026-07-08T01:20:56Z","isPatch":true,"body":"The document describes an idealized life cycle for a patch series,\nwhere an author scratches their itch, improves the patch(es) with\nhelp from fellow reviewers, and iterate until their work becomes a\npart of Git.\n\nBut sometimes a topic may have to be abandoned or retracted, with an\noption to later resurrect it when they can, and it is much better\nthan leaving a topic in limbo. Clearly state that we encourage\ncontributors to explicitly retract their topic that did not succeed.\n\nSigned-off-by: Junio C Hamano \n---\n Documentation/SubmittingPatches | 15 +++++++++++++++\n 1 file changed, 15 insertions(+)\n\ndiff --git c/Documentation/SubmittingPatches w/Documentation/SubmittingPatches\nindex f042bb5aaf..f14ae20aaa 100644\n--- c/Documentation/SubmittingPatches\n+++ w/Documentation/SubmittingPatches\n@@ -95,6 +95,21 @@ input and avoids unnecessary churn from many rapid iterations.\n top, it gets merged to the 'master' branch and waits to become part\n of the next major release.\n \n+But sometimes things do not work as planned.\n+\n+. A discussion on the list might convince you that your changes are\n+ not such a good idea, in which case you are expected to explicitly\n+ retract the topic, to releave the maintainer from having to worry\n+ about it.\n+\n+. You may have to stop pursuing the topic due to various reasons like\n+ lack of time, other commitments, shifting priorities, etc. It is a\n+ friendly thing to do to tell the list in such a case, so that others\n+ interested in the topic can take over the topic and continue. When\n+ there is no taker, the maintainer may have to discard the topic, but\n+ anybody can resurrect the topic later when they (including you) can\n+ spend more time on it.\n+\n In the following sections, many techniques and conventions are listed\n to help your patches get reviewed effectively in such a life cycle.\n \n"},{"id":"547511","messageId":"xmqqpl0xv25e.fsf@gitster.g","threadId":"65948","inReplyTo":"xmqqzf02xonc.fsf@gitster.g","subject":"[PATCH v2] SubmittingPatches: document how to retract a topic","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2026-07-08T17:09:49Z","receivedAt":"2026-07-08T17:09:51Z","isPatch":true,"body":"While this document outlines an idealized lifecycle where an author\ndevelops a patch, refines it with reviewer feedback, and\nsuccessfully merges it into Git, reality is rarely so seamless.\n\nSometimes, a topic must be abandoned. Doing so explicitly is far\nbetter than leaving it in limbo, especially since topics can always\nbe resurrected later.\n\nClearly state that we encourage contributors to retract any topic\nthat does not pan out.\n\nSigned-off-by: Junio C Hamano \n---\n\n * Added the third bullet that talks about when and how a topic\n becomes stalled and discarded.\n\n Documentation/SubmittingPatches | 14 ++++++++++++++\n 1 file changed, 14 insertions(+)\n\ndiff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\nindex d2d82eb543..c269e474e3 100644\n--- a/Documentation/SubmittingPatches\n+++ b/Documentation/SubmittingPatches\n@@ -123,6 +123,20 @@ of review.\n top, it gets merged to the 'master' branch and waits to become part\n of the next major release.\n \n+But sometimes things do not work as planned:\n+\n+. If a mailing list discussion convinces you that your changes aren't\n+ ideal, please explicitly retract the topic to save the maintainer\n+ time and effort.\n+\n+. If you must drop a topic due to shifting priorities, lack of time,\n+ or other commitments, notify the list as a courtesy so others can\n+ take over. Anyone can resurrect the topic later when they have the\n+ capacity to do so.\n+\n+. Topics with unaddressed review comments that remain inactive for\n+ four weeks may be discarded by the maintainer.\n+\n In the following sections, many techniques and conventions are listed\n to help your patches get reviewed effectively in such a life cycle.\n \n-- \n2.55.0-302-gdbd766b094\n\n"},{"id":"547524","messageId":"ak6U07K1dQPlXxIp@nixos","threadId":"65948","inReplyTo":"xmqqpl0xv25e.fsf@gitster.g","subject":"Re: [PATCH v2] SubmittingPatches: document how to retract a topic","fromName":"Michael Montalbo","fromEmail":"mmontalbo@gmail.com","sentAt":"2026-07-08T18:23:30Z","receivedAt":"2026-07-08T18:23:32Z","isPatch":true,"body":"On Wed, Jul 08, 2026 at 10:09:49AM -0700, Junio C Hamano wrote:\n> While this document outlines an idealized lifecycle where an author\n> develops a patch, refines it with reviewer feedback, and\n> successfully merges it into Git, reality is rarely so seamless.\n> \n> Sometimes, a topic must be abandoned. Doing so explicitly is far\n> better than leaving it in limbo, especially since topics can always\n> be resurrected later.\n> \n> Clearly state that we encourage contributors to retract any topic\n> that does not pan out.\n> \n> Signed-off-by: Junio C Hamano \n> ---\n> \n> * Added the third bullet that talks about when and how a topic\n> becomes stalled and discarded.\n> \n> Documentation/SubmittingPatches | 14 ++++++++++++++\n> 1 file changed, 14 insertions(+)\n> \n> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches\n> index d2d82eb543..c269e474e3 100644\n> --- a/Documentation/SubmittingPatches\n> +++ b/Documentation/SubmittingPatches\n> @@ -123,6 +123,20 @@ of review.\n> top, it gets merged to the 'master' branch and waits to become part\n> of the next major release.\n> \n> +But sometimes things do not work as planned:\n> +\n> +. If a mailing list discussion convinces you that your changes aren't\n> + ideal, please explicitly retract the topic to save the maintainer\n> + time and effort.\n> +\n> +. If you must drop a topic due to shifting priorities, lack of time,\n> + or other commitments, notify the list as a courtesy so others can\n> + take over. Anyone can resurrect the topic later when they have the\n> + capacity to do so.\n> +\n> +. Topics with unaddressed review comments that remain inactive for\n> + four weeks may be discarded by the maintainer.\n> +\n\nNice, I think these points read smoothly and the additional \"four weeks\nuntil may be discarded\" guidance is helpful.\n\nLGTM.\n"}]}