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

[Michael Catanzaro <mcatanzaro gnome org>]

On Thu, 2015-03-19 at 07:17 -0400, Carlos Soriano Sanchez wrote:
> I finished, and I linked BuildGnome on GnomeLove as the *official*
> guide.
> One month after that Ryan Lortie write a full jhbuild guide in
> HowDoI/Jhbuild because he thought there were no guide for jhbuild! 
> He is a experienced developer and couldn't notice we had 3 jhbuild
> guides at that point! Clearly we are doing something wrong...
> So what now? After he spent that much time writing that very well
> explained guide, I say to him: hey sorry, I'm going to delete because 
> we already have others and in GnomeLove we already have one linked.

Having multiple conflicting tutorials is confusing to new contributors,
and harmful when those two tutorials are incompatible. I would much
rather we have one and only one introduction to GNOME development.
Surely developer.gnome.org is the right place for this. I would love to
see the wiki pages replaced by a link to a tutorial on
developer.gnome.org. I don't think making the material harder to edit is
necessarily problematic: the page should primarily be edited by
experienced GNOME developers, and we know how to submit patches for
gnome-devel-docs, and when inexperienced users want to edit the page
they can use the friendly "Got a comment? Spotted an error? Found the
instructions unclear? Send feedback about this page" on the bottom.
(This is not to say that I think the current workflow for updating the
developer documentation is ideal, but it's not so bad that we should
keep documentation on the wiki instead.)