Re: Revamping the developer documentation

2013-02-27 Thread Marta Maria Casetti
Hi, It sounds great, and I would love to help with the new docs. I would start by splitting the current Python GTK+ tutorial into a tutorial for beginners (structured as the way the Tutorial for beginners is now: a gradual path through the widgets with some theory; the pages being a gradual build

Re: Revamping the developer documentation

2013-02-26 Thread Allan Day
Hi all, More discussion on #docs today. Since there's interest in writing documentation for people who are new to coding, we agreed that it would be good to have a separate area on developer.gnome.org for beginners. This would allow us to target the main docs towards experienced programmers, but

Re: Revamping the developer documentation

2013-02-26 Thread meg ford
Hi, > > I am ready to revise my tutorial for GTK+ for Python and to help with > completing Taryn Fox's GTK+ tutorial for JavaScript (I think that Meg > Ford is working on that, please correct me if I am wrong). > I was looking at this a little at the DX Hackfest, but I don't have a lot of time to

Re: Revamping the developer documentation

2013-02-26 Thread meg ford
Hi, > > > On 2013-02-26 08:54, meg ford wrote: > >> I think having useful information front and center makes sense, but we are >> trying to present an unfamiliar platform, so I think it's better to have >> some simple examples included on the main site. The majority of >> development >> is less c

Re: Revamping the developer documentation

2013-02-26 Thread David King
Hi Meg On 2013-02-26 08:54, meg ford wrote: I think having useful information front and center makes sense, but we are trying to present an unfamiliar platform, so I think it's better to have some simple examples included on the main site. The majority of development is less complicated than co

Re: Revamping the developer documentation

2013-02-26 Thread Marta Maria Casetti
Hi, As I said on the #docs channel (but I should have had replied here too, sorry!), I think it would not be bad to have both a page for more experienced developers (but still with an example) and a page for beginners (example-centred, with a "if you want to know more" link to the "experienced dev

Re: Revamping the developer documentation

2013-02-26 Thread meg ford
Hi Allan, On Tue, Feb 26, 2013 at 6:39 AM, Allan Day wrote: > Marta Maria Casetti wrote: > > First of all: I really like the mockups. > > Thanks Marta! > > > I also think that we should try to include something for first-time > > programmers, like a tutorial, somewhere. > > It would be really c

Re: Revamping the developer documentation

2013-02-26 Thread Allan Day
Marta Maria Casetti wrote: > First of all: I really like the mockups. Thanks Marta! > I also think that we should try to include something for first-time > programmers, like a tutorial, somewhere. It would be really cool to have a good place for this material. My sense (correct me if I'm wrong

Re: Revamping the developer documentation

2013-02-26 Thread Marta Maria Casetti
Hi, First of all: I really like the mockups. I also think that we should try to include something for first-time programmers, like a tutorial, somewhere. I am ready to revise my tutorial for GTK+ for Python and to help with completing Taryn Fox's GTK+ tutorial for JavaScript (I think that Meg Fo

Re: Revamping the developer documentation

2013-02-26 Thread David King
Hi Allan On 2013-02-25 23:21, Allan Day wrote: As some of you know, I spent some time looking at the developer docs during the recent Developer Experience Hackfest. I was also able to have a short discussion about it yesterday at the Documentation Hackfest in Brno. Here's a brief summary of th

Revamping the developer documentation

2013-02-25 Thread Allan Day
Hi all, As some of you know, I spent some time looking at the developer docs during the recent Developer Experience Hackfest. I was also able to have a short discussion about it yesterday at the Documentation Hackfest in Brno. Here's a brief summary of the ideas that have come out of these discus