From: Eric Sunshine Date: Mon, 22 Sep 2014 23:01:41 GMT Subject: Re: [PATCH v2 22/32] checkout: support checking out into a new working directory Message-ID: In-Reply-To: <54208E01.2060205@xiplink.com> On Mon, Sep 22, 2014 at 5:00 PM, Marc Branchaud wrote: > On 14-09-21 05:50 AM, Duy Nguyen wrote: >> On Sun, Sep 21, 2014 at 10:10 AM, Eric Sunshine 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.