Re: [PATCH v5 1/4] docs: introduce document to announce breaking changes
- From
Patrick Steinhardt <ps@pks.im>
- Date
- Jun 4, 2024, 06:59 UTC
- 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:
Show 10 quoted lines
> 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