Re: [PATCH] docs: minor grammar fixes for v1.7.9 release notes

2 messages, 2 authors, 2016-06-15 · open the first message on its own page

Re: [PATCH] docs: minor grammar fixes for v1.7.9 release notes

From: Junio C Hamano <hidden>
Date: 2016-06-15 22:52:52

Jeff King [off-list ref] writes:
Signed-off-by: Jeff King <redacted>
---
Easier to view with --color-words, of course.
Thanks ;-)
... (I notice you mostly include features and not bug-fixes, which I
assume is to keep the list to a readable length).
Actually my intention regarding fixes are:

 - never mention follow-up fixes to new topics merged since v1.7.8 at all;

 - omit mentioning trivial fixes that not many people would be bitten by
   and actually be hurt in real life (i.e. typo in an error message); and

 - make sure as many fixes are covered in "Fixes since v1.7.8" section.

So "keep the list short" is only one-third of the motivation.

Re: [PATCH] docs: minor grammar fixes for v1.7.9 release notes

From: Jeff King <hidden>
Date: 2016-06-15 22:52:52

On Thu, Jan 26, 2012 at 11:15:08AM -0800, Junio C Hamano wrote:
quoted
... (I notice you mostly include features and not bug-fixes, which I
assume is to keep the list to a readable length).
Actually my intention regarding fixes are:

 - never mention follow-up fixes to new topics merged since v1.7.8 at all;

 - omit mentioning trivial fixes that not many people would be bitten by
   and actually be hurt in real life (i.e. typo in an error message); and

 - make sure as many fixes are covered in "Fixes since v1.7.8" section.

So "keep the list short" is only one-third of the motivation.
That makes sense.

I was specifically thinking of 02f7914 (remote-curl: don't pass back
fake refs), because "git push --mirror" failing is an often-reported bug
for github (and the solution is to upgrade your git client). But looking
again, I see that the fix was actually in v1.7.8.2, so it is included by
the "...and all of the fixes in the maintenance releases" text.

In general, it seems like most of our fixes go onto the maintenance
track, so the "fixes" section of a major release ends up being empty.
Which I think is a good thing.

-Peff
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help