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

2015-04-21 Thread Magdalen Berns
On Thu, Mar 19, 2015 at 11:22 AM, Carlos Soriano Sanchez 
csori...@redhat.com wrote:

 Hi Magdalen,

 Thanks for your kind words.
 Still people like Allan and other people did a lot of work on this as well.
 I can provide my feelings when started contributing and personal vision,
 but they have the experience.


I appreciate this. My main consideration I was urging Allan (and others
generally) to make here, is that with increasing experience it can become
harder and harder to remember what it's like to actually be a newcomer and
see these things through their eyes. The experience of navigating through
all this documentation between the wiki.gnome.org and developer.gnome.org,
trying to figure out which documentation is reliable before carrying out
commands, is something that is easy to forget about, and that's a bit of an
inevitability; so it's understandable, but because of that, we probably all
need to try to be weary of as time goes on.


 So I won't go alone on this if they don't agree =) That would mean I'm
 missing something.


I wasn't suggesting you go it alone. I was giving my opinion on your
proposal, given that this seemed to be what you were after. If you are only
interested in feedback from specific people then it's probably advisable to
make that clear from the outset.

Magdalen
___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list


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

2015-04-21 Thread Magdalen Berns
Hi Allan,

On Wed, Mar 18, 2015 at 12:17 PM, Carlos Soriano Sanchez 
csori...@redhat.com wrote:

 Hi Allan,

 So if we continue with the wiki, most of the points I pointed before
 continue to be a problem...

 New jhbuild/git/whatever tutorials will came up... people won't find the
 appropriate one given that the wiki
 is not official.


Echo this. The developer.gnome jhbuild instructions are quite misleading
because they are not up to date. Yet, this is where newcomers are
rightfully, most likely to look first and to trust most.


 i.e. people say: it's a wiki, just modify it! Which is true, but I don't
 think we want that
 for something like this.
 Some people will prefer one tutorial over the other, and we will continue
 to link different
 tutorials and continue maintaining all of them and having to deal with a
 mix set up of the newcomers
 and newcomers will continue to be confused going back and forward on
 different guides.


This.

Carlos seems to be doing a good job of empathising with newcomers in this
proposal and personally, I think his assessment is pretty on the money.
Tutorials need to be trustworthy, current, comprehensive and provide step
by step guides to really be able to help a newcomer get to grips with a
concept or skill in certain cases e.g. jhbuild. Carlos has identified a
barrier newcomers face when they are learning about GNOME and his suggested
solution seems pretty sensible.

We can agree on something like this wiki tutorial is the one we recommend,
 but we can't enforce it
 at all if we not move to a official page like developers.gnome.org

 So if it is a matter of logical splitting about 3rd party apps and Gnome
 contribution, I don't think it matters that much
 in practice no?

 What do you propose to fix these problems if not? This is the only idea
 that came to my mind.

 Cheers,
 Carlos Soriano
 ___
 desktop-devel-list mailing list
 desktop-devel-l...@gnome.org
 https://mail.gnome.org/mailman/listinfo/desktop-devel-list

___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list