Re: [PATCH v2 22/32] checkout: support checking out into a new working directory

From: Eric Sunshine <sunshine@sunshineco.com>
Date: Sep 22, 2014, 23:01 UTC
Message-ID: <CAPig+cTVO0JvBB_gBRkFBhGKh8Y=iZ40j4x+K8X0d9fm04nMgw@mail.gmail.com>
In-Reply-To: <54208E01.2060205@xiplink.com>

On Mon, Sep 22, 2014 at 5:00 PM, Marc Branchaud <marcnarc@xiplink.com> wrote:

Show 7 quoted lines

> On 14-09-21 05:50 AM, Duy Nguyen wrote:
>> On Sun, Sep 21, 2014 at 10:10 AM, Eric Sunshine <sunshine@sunshineco.com> wrote:
>>> Would it make sense for this "rule of thumb" summary to be presented
>>> first, and then the explanation of that rule after, rather than the
>>> reverse as is currently the case?
>>
>> You mean like this?

Not quite. It was a genuine question rather than an outright suggestion for change. It is typical to present a high-level overview and then the low-level details. This case reverses that and presents the details first and then the overview (in the form of --git-path). The reader wades through several paragraphs of detailed explanation of the low-level structure of the .git directory, only to be told at the end to use --git-path and not worry about those details. Thus, the organization struck me as a bit odd.

> *shrug*  To me it seems better to leave it at the end here.

The text does work as-is, and presents the necessary information; and I don't want to turn this into a bike-shedding session, so feel free to ignore my question.