On Thu, Mar 04, 2010 at 11:04:04AM -0500, John J. McDonough wrote: > On Thu, 2010-03-04 at 10:52 -0500, Paul W. Frields wrote: > > > So how many of the guides are using git? From my look at > > fedorahosted.org, it's the majority. That's good because git makes it > > dead-simple to make fixes, generate a patch, and then email it to the > > list where it can be used. > > I do believe that is correct, and I was aware of being able to generate > patches. That is really good from the standpoint of a new contributor > who would likely be a little squeamish about making changes directly to > the repo. > > However, if the guide owner isn't around and we queue up a bunch of > patches, it could get pretty messy. But then, I suppose that serves as > penance for not being available :-) > > > There are some good setup hints for git here: > > https://fedoraproject.org/wiki/Git_Quickref > > Everybody should put a shortcut to that in their browser, but I do have > mixed feelings about it. There is a lot to git, but for 99% of the > things you do, that page goes into way more detail than you need, even > though it probably only covers 10% of what you might do. Yeah, I think you're right. I looked mostly at the setup hints at the top, but there are probably other choices one could make about what people need to know. Maybe we should adopt and fix that page. :-) The basic information that a newbie needs to know to install and configure git, clone a repository, and make/send a patch are the most important things to show at the top, IMHO. Everything else can be shown in escalating degrees of difficulty below. > > It would be best if guide owners could make sure they have several > > sponsors in addition to themselves who can grant user access. > > Absolutely it would, and not just for this weekend. I think it is good > practice to have some backup. -- Paul W. Frields http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://redhat.com/ - - - - http://pfrields.fedorapeople.org/ Where open source multiplies: http://opensource.com -- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
