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.) _______________________________________________ gnome-doc-list mailing list [email protected] https://mail.gnome.org/mailman/listinfo/gnome-doc-list
