Hi Michael Hill,

Didn't you received private messages from newcomers overwhelmed with the 
different ways on how to contribute a patch?
On how to do this or that in git?  On how to know the code style? On how to 
just get the code? Why I have to read multiple tutorials?
Because I did. And guides of different kinds came up...

Also, did you see the questions of newcomers in gnome-love?
They ask those things.

And we, people helping, waste time figuring out their set up. Why are you 
developing the patch in master? Why don't you create a branch? You just lose
all the work you have been doing... "oh but that guide told me...." yes I know, 
sorry for that, I didn't know you were following that guide and not this other 
one.

I feel heartbreaked every time a newcomer says to me this is too much trouble 
and confusing. They just want a unique short guide to hack their firsts patches.

I am not testing only how a beginner person that came to a hackfest, given a 
tutorial on jhbuild and fedora distro, how it successfully builds.
This is only the tip of the iceberg. Jhbuild is just a a part of a tool for 
something much bigger. Discovering and contributing to Gnome.

Cheers,
Carlos Soriano

----- Original Message -----
From: "Michael Hill" <[email protected]>
To: "Michael Catanzaro" <[email protected]>
Cc: "desktop-devel-list" <[email protected]>, "gnome-doc-list" 
<[email protected]>
Sent: Thursday, 19 March, 2015 2:54:33 PM
Subject: Re: Proposal to make GnomeLove official and move it to 
developer.gnome.org

On Thu, Mar 19, 2015 at 9:11 AM, Michael Catanzaro < [email protected] > 
wrote: 



Having multiple conflicting tutorials is confusing to new contributors, 
and harmful when those two tutorials are incompatible. 

Disclaimer: I am not a jhbuild beginner. 

Please find an example other than jhbuild for harmful incompatible tutorials. 
Regardless of other documentation that existed when the HowDoI was created, it 
is actively updated as jhbuild changes by Ryan, a developer and contributor to 
jhbuild. It has proven ideal in a hackfest environment for all levels of user 
(although an intern at a hackfest can't be classified as a beginner either). 

It's where I look to see what has changed with jhbuild since the last time I 
ran it, and is arguably the best source of information for other tutorials 
whose goal is to *not* conflict. It regularly achieves legitimacy by being 
replicated on developer.gnome.org , where it's cleverly concealed from 
beginners performing case-sensitive searches. It brings the perspective of 
multiple platforms. 

Mike 


_______________________________________________
gnome-doc-list mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/gnome-doc-list
_______________________________________________
gnome-doc-list mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Reply via email to