Re: Git documentation reorganization and cleanup

[Alberto Ruiz <aruiz gnome org>]

2009/4/18 Sandy Armstrong <sanfordarmstrong gmail com>:
> Hi all,
>
> Just a quick note that I've been working a bit on cleaning up our git
> documentation.  It is now centralized here:
>
> http://live.gnome.org/Git
>
> And the main developer howto has been simplified.  It now recommends a
> single simple workflow of hacking, making a single commit, and
> generating a patch using `git format-patch HEAD^`:
>
> http://live.gnome.org/Git/Developers
>
> I really want to keep this page comprehensible for new contributors,
> as much as we can.  If you have ideas for how to improve it, any help
> is welcome.  Please keep in mind that I'm actually pretty new to git,
> and may not be aware of better workflows for new contributors.
Hi Sandy,

great job. However I miss some docs for maintainers of new modules.
In freedesktop when you have a new empty repository, you can't clone
that repository (something that sounds like the natural first step,
specially for people used to subversion). So you have to create your
own repository, push it, and then set the origin properly.

I found this step pretty confusing at the time.

> I'd like to add Git/FAQ and a page about workflows and/or branching
> strategies, as well as how to share branches via gitorious, github,
> etc.  If anyone is interested in this, any content is better than no
> content.  I'd rather see a FAQ full of unanswered questions than a
> blank one.  :-)
>
> I'm also particularly interested in having good documentation for
> Windows and Mac users, so if anybody is already working on something
> similar, I'd love to hear about it.  Let's try to keep our git
> documentation under l.g.o/Git/.
>
> Best,
> Sandy
> _______________________________________________
> desktop-devel-list mailing list
> desktop-devel-list gnome org
> http://mail.gnome.org/mailman/listinfo/desktop-devel-list
>



-- 
Un saludo,
Alberto Ruiz