On Mon, Sep 22, 2014 at 5:00 PM, Marc Branchaud <marcnarc@xxxxxxxxxxx> wrote: > On 14-09-21 05:50 AM, Duy Nguyen wrote: >> On Sun, Sep 21, 2014 at 10:10 AM, Eric Sunshine <sunshine@xxxxxxxxxxxxxx> 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. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html