From: Patrick Steinhardt <ps@pks.im>
Date: Tue, 04 Jun 2024 06:59:22 GMT
Subject: Re: [PATCH v5 1/4] docs: introduce document to announce breaking changes
Message-ID: <Zl67SnAQbtnxzAxS@framework>
In-Reply-To: <xmqqv82q56zz.fsf@gitster.g>

On Mon, Jun 03, 2024 at 09:24:48AM -0700, Junio C Hamano wrote:
> Patrick Steinhardt <ps@pks.im> writes:
> > +This is a living document as the environment surrounding the project changes
> > +over time. An earlier decision to deprecate or change something may need to be
> > +revisited from time to time. So do not take items on this list to mean "it is
> > +settled, do not waste our time bringing it up again".
> 
> But you are expected to be aware of past discussion, and if you are
> not bringing anything new to the table, you are wasting our time.
> Note that pointing out an old rationale no longer applies to today's
> world still counts as a new datapoint in a renewed discussion.

Yeah. I like Phillip's proposal here, which adds "If circumstances
change" to the second sentence to clarify that we do not want to rehash
the same arguments.

Patrick