[tomboy-list] Tomboy has moved to git. Need new guidelines for contributors! Are you a git expert?

[Sandy Armstrong]

Hi campers,

For those who don't already know, Tomboy has moved to git [1], along
with all of GNOME.  There is basic documentation for using git on the
GNOME wiki [2], but I thought it might be worth discussing how Tomboy
will recommend contributors to use git.  Also, we have our own
documentation [3][4] that needs to be updated.

I am relatively new to git.  I've been using git-svn in my work for a
few weeks now, and I really like it, but I'm not used to contributing
to pure git projects.  If you have any ideas, I'd be glad to hear
them.

Here are the things I am planning.  I will update the wiki with this
info unless I hear better ideas:

1) We are getting rid of ChangeLog.  We can generate for tarball
releases, but I do not think it is helpful to keep it in version
control any more.

2) I want to recommend a workflow of one-commit-per-patch, just to
keep things simple.  Of course, more advanced git users are welcome to
use the tool however they want.  But I think I'll stick with the
current GNOME recommendation of:
* Hack hack hack
* git commit  # And use a good commit message!
* git format-patch

Possible alternatives are recommending no committing and a simple `git
diff` for those used to sending patches but not using version control
systems, or the other extreme of recommending one-branch-per-patch,
with as many commits as you like.

3) I want to recommend tortoisegit to Windows users, but have not had
time to do more than document the install.  Anyone have
experience/recommendations with git on Windows?

4) I am not sure of the best way to get git on OS X 10.4, as all
installers I've found are for 10.5.

We will also need to update our README, and possibly other files.

Am I forgetting anything?  Any ideas?  Any volunteers?

Thanks for your time,
Sandy

[1] http://git.gnome.org/cgit/tomboy/
[2] http://live.gnome.org/Git
[3] http://live.gnome.org/Tomboy/HowToSubmitPatches
[4] http://live.gnome.org/Tomboy/Building/Windows