Re: [PATCH v2] Docs: git checkout --orphan: `root commit' and `branch head'

Michael Witten <mfwitten@gmail.com> writes:

This part used to be just this in v1:

-This can be useful when you want to publish the tree from a commit
-without exposing its full history. You might want to do this to publish
+This can be useful when you want to publish a tree without exposing its
+full history; for instance, you might want to do this to publish
 an open source branch of a project whose current tree is "clean", but
 whose full history contains proprietary or otherwise encumbered bits of
 code.

is it intentionnal that you discarded completely the paragraph? If so, then I disagree, the paragraph was one of the main motivation for someone to use --orphan, without it, someone may understand _what_ it does, but not _why_ it is useful.