Re: Canonical jhbuild documentation

2015-03-13 Thread Carlos Soriano Sanchez
Day allanp...@gmail.com To: Carlos Soriano Sanchez csori...@redhat.com Cc: desktop-devel-list desktop-devel-list@gnome.org Sent: Tuesday, 17 February, 2015 5:40:16 PM Subject: Re: Canonical jhbuild documentation Carlos Soriano Sanchez csori...@redhat.com wrote: ... When I created the series

Re: Canonical jhbuild documentation

2015-03-13 Thread Lasse Schuirmann
:16 PM Subject: Re: Canonical jhbuild documentation Carlos Soriano Sanchez csori...@redhat.com wrote: ... When I created the series of BuildGnome CodeContributionWorkflow my intention was creating a simple straightforward workflow for contributing to Gnome for newcommers to Gnome and/or FOSS

Re: Canonical jhbuild documentation

2015-03-13 Thread Carlos Soriano Sanchez
February, 2015 5:40:16 PM Subject: Re: Canonical jhbuild documentation Carlos Soriano Sanchez csori...@redhat.com wrote: ... When I created the series of BuildGnome CodeContributionWorkflow my intention was creating a simple straightforward workflow for contributing to Gnome for newcommers

Re: Canonical jhbuild documentation

2015-03-13 Thread Carlos Soriano Sanchez
Sent: Tuesday, 17 February, 2015 5:40:16 PM Subject: Re: Canonical jhbuild documentation Carlos Soriano Sanchez csori...@redhat.com wrote: ... When I created the series of BuildGnome CodeContributionWorkflow my intention was creating a simple straightforward workflow for contributing

Re: Canonical jhbuild documentation

2015-03-13 Thread Sriram Ramkrishna
: Tuesday, 17 February, 2015 5:40:16 PM Subject: Re: Canonical jhbuild documentation Carlos Soriano Sanchez csori...@redhat.com wrote: ... When I created the series of BuildGnome CodeContributionWorkflow my intention was creating a simple straightforward workflow for contributing to Gnome

Re: Canonical jhbuild documentation

2015-03-13 Thread Sriram Ramkrishna
On Fri, Mar 13, 2015 at 1:01 PM, Carlos Soriano Sanchez csori...@redhat.com wrote: - What do I propose? So, what we actually need is a Canonical documentation for contributing gnome. In developers.gnome.org. As I offered before for the Jhbuild one, I offer me volunteer (with whoever wants

Re: Canonical jhbuild documentation

2015-02-17 Thread Allan Day
Carlos Soriano Sanchez csori...@redhat.com wrote: ... When I created the series of BuildGnome CodeContributionWorkflow my intention was creating a simple straightforward workflow for contributing to Gnome for newcommers to Gnome and/or FOSS. So the simpler the better. ... BuildGnome it is

Re: Canonical jhbuild documentation

2015-02-13 Thread Carlos Soriano Sanchez
Hello (sorry for the delay, there were some problems with the email) A little of history of the latest wiki jhbuild pages: When I created the series of BuildGnome CodeContributionWorkflow my intention was creating a simple straightforward workflow for contributing to Gnome for newcommers to

Re: Canonical jhbuild documentation

2015-02-12 Thread Allan Day
Sriram Ramkrishna s...@ramkrishna.me wrote: ... I think though, as someone else further in the thread said, we want to make a distinction between 'quick start' and the manual. I honestly don't see why the manual can't contain a quick start section - we do this in other documentation without

Re: Canonical jhbuild documentation

2015-02-12 Thread Frederic Peters
Ekaterina Gerasimova wrote: https://wiki.gnome.org/HowDoI/Jhbuild is the one that seems to be preferred by most docs newcomers and team members so from my point of view it would be good that the final result resembles it and works just as well. Also jhbuild has been absorbing good practices

Re: Canonical jhbuild documentation

2015-02-12 Thread mdhillca
Sri, as the target audience of the HowDoI (as were many fellow attendees at various hackfests), I'd be dismayed if it went away. I'm not a beginner and I don't need to know all the switches, often I just need to know how to get it running again. As Fred says, it's written by someone who can

Re: Canonical jhbuild documentation

2015-02-11 Thread Sriram Ramkrishna
On Wed, Feb 11, 2015 at 4:33 AM, Allan Day allanp...@gmail.com wrote: Sriram Ramkrishna s...@ramkrishna.me wrote: ... Seems like you should talk this through with Carlos and Ryan - they're the effective maintainers of the wiki pages in question. I know that Carlos is keen to reduce the amount

Re: Canonical jhbuild documentation

2015-02-11 Thread Frederic Peters
Germán Poo-Caamaño wrote: IMHO, the jhbuild documentation is more like a reference manual, whereas the information for newcomers is like a tutorial (or expected to be). Indeed it's mostly like that at the moment. Maybe both could be in the same documentation/place, but the separation

Re: Canonical jhbuild documentation

2015-02-11 Thread Frederic Peters
Allan Day wrote: It would be nice if somebody could contact the authors: James Henstridge james at jamesh.id.au C.J. Adams-Collier cjcollier at colliertech.org Frederic Peters (ok, done) David Turner (Cillian64, from GHOP, back in 2007/2008, I can't find an

Re: Canonical jhbuild documentation

2015-02-11 Thread Allan Day
Frederic Peters fpet...@gnome.org wrote: ... I believe this is no longer a problem; when I tried to merge the by-then new BuildGnome page into the manual, and converting it to Mallard, the primary problem was of license incompatibility between the contents from the wiki and the existing

Re: Canonical jhbuild documentation

2015-02-11 Thread Allan Day
Sriram Ramkrishna s...@ramkrishna.me wrote: ... Seems like you should talk this through with Carlos and Ryan - they're the effective maintainers of the wiki pages in question. I know that Carlos is keen to reduce the amount of duplication. Yes, I sent this email after consulting with him and

Re: Canonical jhbuild documentation

2015-02-11 Thread Germán Poo-Caamaño
On Wed, 2015-02-11 at 12:33 +, Allan Day wrote: Sriram Ramkrishna s...@ramkrishna.me wrote: [...] Um, I don't think it is. You originally said: So Proposal is: https://wiki.gnome.org/GnomeLove/BuildGnome is the only documentation on wiki.gnome.org, the rest gets retired and merged

Re: Canonical jhbuild documentation

2015-02-11 Thread Ekaterina Gerasimova
On 11/02/2015, Frederic Peters fpet...@gnome.org wrote: Allan Day wrote: It would be nice if somebody could contact the authors: James Henstridge james at jamesh.id.au C.J. Adams-Collier cjcollier at colliertech.org Frederic Peters (ok, done) David Turner (Cillian64, from GHOP,

Re: Canonical jhbuild documentation

2015-02-10 Thread Michael Hill
On Tue, Feb 10, 2015, at 01:00 PM, Ekaterina Gerasimova wrote: https://wiki.gnome.org/HowDoI/Jhbuild is the one that seems to be preferred by most docs newcomers and team members so from my point of view it would be good that the final result resembles it and works just as well. jhbuilding

Re: Canonical jhbuild documentation

2015-02-10 Thread Tim
On 11/02/15 12:28, Michael Hill wrote: On Tue, Feb 10, 2015, at 01:00 PM, Ekaterina Gerasimova wrote: https://wiki.gnome.org/HowDoI/Jhbuild is the one that seems to be preferred by most docs newcomers and team members so from my point of view it would be good that the final result resembles

Re: Canonical jhbuild documentation

2015-02-10 Thread Frederic Peters
Allan Day wrote: People will always come across the official manual on developer.gnome.org, since this ranks highly in search results. So, if you really want people to easily find the introductory documentation, it will have to live as a part of the official manual. I get the The most

Re: Canonical jhbuild documentation

2015-02-10 Thread Allan Day
Sriram Ramkrishna wrote: Problem: we have many pages on jhbuild documentation Let's list them: 1. https://wiki.gnome.org/Projects/Jhbuild 2. https://developer.gnome.org/jhbuild/unstable/ 3. https://wiki.gnome.org/GnomeLove/BuildGnome 4. https://wiki.gnome.org/GnomeLove/JhbuildIntroduction

Re: Canonical jhbuild documentation

2015-02-10 Thread Ekaterina Gerasimova
On 10/02/2015, Sriram Ramkrishna s...@ramkrishna.me wrote: Problem: we have many pages on jhbuild documentation We want to eliminate all of this and have https://wiki.gnome.org/GnomeLove/BuildGnome There seems to be some objections to removing some of the more in-depth jhbuild

Re: Canonical jhbuild documentation

2015-02-10 Thread Sébastien Wilmet
Hi, On Tue, Feb 10, 2015 at 11:27:11AM -0800, Sriram Ramkrishna wrote: Problem: we have many pages on jhbuild documentation Let's list them: 1. https://wiki.gnome.org/Projects/Jhbuild 2. https://developer.gnome.org/jhbuild/unstable/ 3. https://wiki.gnome.org/GnomeLove/BuildGnome 4.

Re: Canonical jhbuild documentation

2015-02-10 Thread Michael Catanzaro
In particular, we should identify material from the HowDoI/Jhbuild page (which conflicts with the guidance on the BuildGnome page) that we want to keep, and merge it into the BuildGnome page. We should not have competing pages with competing advice; it's way too confusing for newcomers.

Re: Canonical jhbuild documentation

2015-02-10 Thread Frederic Peters
Sébastien Wilmet wrote: Hi, On Tue, Feb 10, 2015 at 11:27:11AM -0800, Sriram Ramkrishna wrote: Problem: we have many pages on jhbuild documentation Let's list them: 1. https://wiki.gnome.org/Projects/Jhbuild 2. https://developer.gnome.org/jhbuild/unstable/ 3.

Re: Canonical jhbuild documentation

2015-02-10 Thread Ekaterina Gerasimova
On 10/02/2015, Frederic Peters fpet...@gnome.org wrote: Allan Day wrote: People will always come across the official manual on developer.gnome.org, since this ranks highly in search results. So, if you really want people to easily find the introductory documentation, it will have to live as

Re: Canonical jhbuild documentation

2015-02-10 Thread Sriram Ramkrishna
On Tue, Feb 10, 2015 at 1:06 PM, Allan Day allanp...@gmail.com wrote: Sriram Ramkrishna wrote: Problem: we have many pages on jhbuild documentation Let's list them: 1. https://wiki.gnome.org/Projects/Jhbuild 2. https://developer.gnome.org/jhbuild/unstable/ 3.