Junio C Hamano wrote: > * tr/workflow-doc (Sat Sep 13 18:11:01 2008 +0200) 2 commits > + Documentation: Refer to git-rebase(1) to warn against rewriting > + Documentation: new upstream rebase recovery section in git-rebase > > I think the last one on "recommended practice" needs discussion. I do not > think it describes _the_ recommended workflow, although I think (1) what > is recommended in the draft does make sense within its own scope, and (2) > it may be impossible to come up with _the_ recommended workflow anyway. [The patch referred to is http://article.gmane.org/gmane.comp.version-control.git/95806 and the only response so far, to an earlier version, http://article.gmane.org/gmane.comp.version-control.git/95620 ] I was hoping for more feedback, but maybe the list is not the right audience: the intended readers of the document probably aren't as active on the list and confident about patch review. Regarding _the_ recommended workflow, I can think of a few possible approaches: a) Authoritative: either because we really believe it's the One True Workflow, or just because we want to sound so. b) Descriptive: describe it as the workflow "we" use (presumably this includes linux.git which may be worth mentioning; I haven't touched the kernel though). c) Encyclopedic: describe and classify as many recipes (building blocks) and workflows as possible in an attempt to build a complete reference of sorts. d) Blind eye: we're just the tool. Others can devise workflows. I certainly aimed the patch at (a), since I wanted to be able to point people at it (mostly on #git). The resources I learned Git with, except for the videos, just show simple examples of pull/push usage, which I found both unsatisfactory (e.g. I want to know _why_ it's a good idea to make topic branches) and incomplete. This list is an excellent place to learn, but I doubt that's an effort the average user is willing to put in. That being said, I'm certainly willing to rewrite it in the direction of (b), and possibly help with the writeup (though not brainstorming) of (c), if either of those is the list consensus. - Thomas PS: Anyone else noticed the striking number of "we have <setup>, what is the best workflow and how do I implement it" mails in the past few days? Is that just a statistical anomaly, or another need for documentation? -- Thomas Rast trast@xxxxxxxxxxxxxxx
Attachment:
signature.asc
Description: This is a digitally signed message part.
