Re: Proposal to make GnomeLove official and move it to developer.gnome.org

[Carlos Soriano Sanchez <csoriano redhat com>]

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" <mdhillca gmail com>
To: "Michael Catanzaro" <mcatanzaro gnome org>
Cc: "desktop-devel-list" <desktop-devel-list gnome org>, "gnome-doc-list" <gnome-doc-list gnome org>
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 < mcatanzaro gnome org > 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
gnome-doc-list gnome org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list