On Wed, Aug 06, 2014 at 10:35:31AM -0700, Junio C Hamano wrote:
> While I agree that it is a very good idea to state "what it does,
> what it is for" with the very first sentence of the paragraph,
> "separate the git repository from your working tree" does not say
> much more than the name of the option "--separate-git-dir" already
> tells the reader.
Ah, I see.
> And I do not offhand think of a better version
> (and obviously I didn't think of any when the current text was
> reviewed and committed). The second sentence in your version is
> definitely an improvement over the first and the second sentences of
> the original ("where it is supposed to be" does not give any new
> information to those who don't know, and does not help those who
> already know).
OK.
> Perhaps we can simply remove the first sentence from your version?
Yes, I agree. I enjoy cutting excess verbiage.
--
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