Re: Proposal to make GnomeLove official and move it to developer.gnome.org
On 17/03/15 13:33, Carlos Soriano Sanchez wrote: Hi, So after some work in GnomeLove and discussions in the gnome-love list, I would like to make this proposal. Read more here https://wiki.gnome.org/CarlosSoriano/GnomeLoveMoveTask So I would want to have feedback on this idea over this week, since I will take a intern from OPW for it, and the deadline is next Monday. What do you think? =) My 2cents: GnomeLove is a bad name (it's already overlapping with the keyword that we add to bugzilla bugs for newcomers). So I would agree on moving it to .gnome.org as a subdomain, but changing the name, and at the same time making it clear what is for 3rd party developers and what is for Gnome development. Therefore, my proposal would be: 1. Move developer.gnome.org's contents to developer.tech.gnome.org. 2. Move GnomeLove contents to developer.desktop.gnome.org. Hope that helps, Andrés -- ___ 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
On Thu, Mar 19, 2015 at 9:11 AM, Michael Catanzaro mcatanz...@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
Re: Proposal to make GnomeLove official and move it to developer.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.) ___ 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
On Thu, 2015-03-19 at 13:42 +0100, Andres G. Aragoneses wrote: On 17/03/15 13:33, Carlos Soriano Sanchez wrote: Hi, So after some work in GnomeLove and discussions in the gnome-love list, I would like to make this proposal. Read more here https://wiki.gnome.org/CarlosSoriano/GnomeLoveMoveTask So I would want to have feedback on this idea over this week, since I will take a intern from OPW for it, and the deadline is next Monday. What do you think? =) My 2cents: GnomeLove is a bad name (it's already overlapping with the keyword that we add to bugzilla bugs for newcomers). So I would agree on moving it to .gnome.org as a subdomain, but changing the name, and at the same time making it clear what is for 3rd party developers and what is for Gnome development. Therefore, my proposal would be: 1. Move developer.gnome.org's contents to developer.tech.gnome.org. 2. Move GnomeLove contents to developer.desktop.gnome.org. Hope that helps, Andrés I don't agree. developer.gnome.org is already an index linking to HIG, GNOME Platform Demos (*Introductory tutorials to get you started*), Guides, API Reference. Carlos's material belongs under that second category. It just needs a rename to better match its subtitle. Plus, this avoids the need to either buy a double-wildcard TLS certificate (I don't want to think about how expensive that would be) or buy two new ones. ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
a11y-devel-guide related discussion
Hello, GNOME Docs folks! There was an interesting thread on the Fedora desktop list recently started by a visually impaired user. It started with a long rant about issues with a11y (note, it's quite long, but thankfully is pretty mild by most standards): https://lists.fedoraproject.org/pipermail/desktop/2015-March/011714.html The next day the same user came back and apologized and also pointed out many good things about a11y especially in GNOME (again, pretty long): https://lists.fedoraproject.org/pipermail/desktop/2015-March/011716.html This note led to a further discussion about contribution, and one of the areas that came up was the GNOME accessibility-devel-guide: https://lists.fedoraproject.org/pipermail/desktop/2015-March/011719.html I brought this topic to GNOME Docs to see if this guide is actively maintained in this team, or whether I should contact someone else (or simply file this as a RFE/bug). Thanks for any help you can provide! -- Paul W. Frieldshttp://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://redhat.com/ - - - - http://pfrields.fedorapeople.org/ The open source story continues to grow: http://opensource.com ___ 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
Hi Carlos, On Thu, Mar 19, 2015 at 10:28 AM, Carlos Soriano Sanchez csori...@redhat.com wrote: 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. I applaud your efforts to address these issues for beginners. I was trying to correct the misconception held by Michael and others that the goal is to eliminate HowDoI/Jhbuild, a useful tool that isn't *only* for beginners. Mike ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
