Junio C Hamano <gitster <at> pobox.com> writes: > I think in general our documentation aims to spell out _all_ that happens, ... > I am wondering if there is a systemic failure... > ,,,If so are there things that we could > do better without going through individual description? Yes, I would say that there is one obvious systemic failure. Nowhere is it documented (as far as I am aware) that this is the way the git documentation should be read. Since, in this regard, it differs from most software documentation, it ought itself to be documented, perhaps on the top-level git man page. -P. -- 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