Re: [ANNOUNCE] GIT 1.5.3

[Junio C Hamano <gitster@pobox.com>]

Steven Grimm <koreth@midwinter.com> writes:

> No argument there, of course; it needs to be documented. But maybe not
> as the very first item at the top of the release notes, which people
> might expect to be organized in a "most user-visible first" order. I
> usually expect to see general descriptions of new features and
> critical bugfixes at the top of a program's release notes, with the
> option to keep reading if I want the low-level details.
>
> Barring that, or even in addition to that, would it make sense to have
> separate "porcelain" and "plumbing" sections of the release notes?

I think that makes sense, as "most user-visible first" order
will be different what kind of "user" you are.