Re: newbie: need concrete examples for how the linux-kernel project uses git

From: Jonathan Nieder <jrnieder@gmail.com>
Date: May 5, 2010, 01:10 UTC
Message-ID: <20100505011045.GA16345@progeny.tock>
In-Reply-To: <m2i408104421005041431l6c8b5845ld57720c2127fbb00@mail.gmail.com>

Hi Robert,

Robert Buck wrote:

Show 6 quoted lines

> We have multiple teams, lots of developers, and would like to use a
> variant of the dictator-lieutenant scheme discussed in published
> subject matter.
> 
> However, I find it rather challenging finding any subject matter that
> provides reasonable detail.

Probably you have run into these already.  But for reference...

To be a maintainer:

 - the gitworkflows(7) page[1]

The kernel does not follow all of these practices, but maybe similar projects could benefit from some. :)

To be a “leaf” contributor (does not require git):

 - the Linux wireless git guide[2]
 - submitting patches to linux-wireless.git[3]
 - guide to tip.git (Linux’s x86 architecture support subsystem) [4]

To build a throw-away integration branch:

 - Stephen Rothwell’s linux-next tree[5]

To be, well, anyone:

 - “everyday git in 20 commands or so” [6]

Patch flow:

 - for Linux wireless [7]
 - for git [8]

Separate “internal use” and “public” trees:

 - nouveau/linux-2.6 [9]

> What I'd like to find are concrete
> examples, step-by-step, of specifically how to:

If you find these, information for each about

 - where you expected to find it
 - where you actually found it
 - how helpful that information was

would be very useful. It would be nice to be able to update “everyday git”, the user manual, the reference manual pages, and other documents to make this sort of question easier to answer.

Hope that helps, Jonathan

[1] http://www.kernel.org/pub/software/scm/git/docs/gitworkflows.html [2] http://wireless.kernel.org/en/developers/Documentation/git-guide [3] http://wireless.kernel.org/en/developers/Documentation/SubmittingPatches [4] http://people.redhat.com/mingo/tip.git/readme.txt [5] http://git.kernel.org/?p=linux/kernel/git/next/linux-next.git;a=tree;f=Next [6] http://www.kernel.org/pub/software/scm/git/docs/everyday.html [7] http://wireless.kernel.org/en/developers/process [8] https://git.wiki.kernel.org/index.php/MaintNotes [9] http://lists.freedesktop.org/archives/nouveau/2009-March/002765.html http://cgit.freedesktop.org/nouveau/linux-2.6/ ‘git rebase’ is the main tool here.