"J. Bruce Fields" <bfields@fieldses.org> writes:

quoted text
> I do feel bad about adding yet another piece of documentation, but I we
> need something that goes through all the basics in a logical order, and
> I wasn't seeing how to grow the tutorials into that.
>
> Opinions?

I was having the feeling that we need to start over the
documentation from a clean slate by first coming up with a
coherent presentation order and then filling sections in it,
instead of tweaking existing documents here and there.  The
existing documents were written in different development stages
of git, and each document tries to be more or less independent
from others in the area it wants to talk about, and reading all
of them in _any_ order is not the best way to learn git because
of duplication.  Also I suspect some information in older
documents, while being still valid and technically correct,
predates invention of a better/simpler alternative.

In other words, I think we have enough information in the
tutorial documents, but the problem is not the lack of
information -- the problem is the lack of organization.

I think this effort of yours is wonderful because it directly
tackles that problem.


-
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html