From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 03 Sep 2007 00:03:22 GMT
Subject: Re: [ANNOUNCE] GIT 1.5.3
Message-ID: <7vr6lgobsl.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <46DB4903.6060100@midwinter.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.