Walter et al.-
I did take the opportunity to add some comments/clarifications to the Git FAQ. If I've misled anywhere, I hope to be corrected.
As it stands now, I feel it is a good beginner tutorial - one that just about anyone could follow fairly easily.
Thanks for both your help and encouragement, Walter - and all others who jumped in.
Art Hunkins
----- Original Message -----
From: Walter Bender
To: James Cameron
Cc: Art Hunkins ; Sugar-devel at lists.sugarlabs.org
Sent: Wednesday, December 29, 2010 9:33 AM
Subject: Re: [Sugar-devel] git problems (reprise)
On Wed, Dec 29, 2010 at 1:03 AM, James Cameron <quozl at laptop.org> wrote:
On Tue, Dec 28, 2010 at 10:16:55PM -0500, Art Hunkins wrote:
> My sources of gitorious info were: the Activity Team/Git FAQ, the
> Activity Team /Git Tutorial, and Importing your project from OLPC.
>
> I found the material disorganized, unnecessarily abstruse and
> technical, and not at all user-friendly (at least for the beginner).
I agree. As I used it, I learned to use other sources of guidance
instead. The material on sugarlabs.org and laptop.org presumes too much
foreknowledge.
> Take, for example, the Git Tutorial - which I expected to be the most
> helpful of the above: three-quarters of the material is nonessential,
> and the info on creating an account and SSH key are grossly
> inadequate. Furthermore, there is no treatment of anything but the git
> *init* procedure - nothing about creating a local depository through
> pulling from gitorious (my particular issue).
Taking your feedback into account, I've reworked the page.
http://wiki.sugarlabs.org/go/Activity_Team/Git_Tutorial
Please review, comment, or edit accordingly.
I made a few changes... the download file system is a bit different than you described. I also did a first pass at reworking the description of git on the Activity_Team ;page itself (incorporating Sascha's text and pointing people towards your tutorial.)
Art, if you could add more clarity there, it may help the next person who comes along.
-walter
--
James Cameron
http://quozl.linux.org.au/
--
Walter Bender
Sugar Labs
http://www.sugarlabs.org
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.sugarlabs.org/archive/sugar-devel/attachments/20101230/b57a163b/attachment-0001.html>