Re: Documentation hackfest in Barcelona
 

Maybe this is a little of topic here. But one thing that I have been struggling with during the pasts weeks is that Qt documentation for Fremantle is quite confusing after the change from 4.5 community supported, to 4.6 technical previews from nokia.
a lot of things simply do not make sense now or are a little bit confusing.
It was discussed in the documentation track in the Barcelona long weekend? ( I attended the programming one )
If not discussed, what do you think about the idea?

Regards

Re: Documentation hackfest in Barcelona
 

Some of you were eager to see the Maemo Developer Guide TOC created during the Barcelona long weekend. Attached, the TOC as a TXT file. Any comments on the TOC are greatly appreciated!

Re: Documentation hackfest in Barcelona
 

Ok, I've finally completed it all. My travelogue of the trip to Barcelona in full on my LJ is available.

Part one: Thursday and Friday are here. (And the pics are live now, but they are big images)

Part two: Saturday and Sunday are here.

Part three: Reflective Meanderings here.

Somehow, I can't capture how amazing it was in words, however hard I try. Not in words they get typed, anyway. When they work out a way to send enthusiasm and energy over tcp/ip, let me know.

Re: Documentation hackfest in Barcelona
 

1) I'd love to have documents like this posted on a public wiki page so that there is read/write access for the community... Not all of the documentation types went to Barcelona... :)

2) Lego?

Re: Documentation hackfest in Barcelona
 

Lego = building blocks.

And I agree about putting the doc somewhere public. :)

Re: Documentation hackfest in Barcelona
 

:D :D I know that! I've got heaps of the stuff.

It just doesn't have a lot of context around it, it isn't entirely clear what that word "Lego" means on a line by itself...

Re: Documentation hackfest in Barcelona
 

Thank your for the TOC!

The TOC deserves a wiki page, sure. Well, it will BE a wiki page just like the Maemo 6 Developer Guide it's bootstrapping. And a separate thread for discussion in the Development forum.

I must say that after a first quick look I honestly disagree :) but before starting the review it would be good to hear the rationale and some opinions from developers. In the new thread.

Re: Documentation hackfest in Barcelona
 

My bad! I failed to provide any information as to the context and the idea behind this exercise.

The TOC was created from scratch, which means that the Fremantle version was not used as a basis. The idea was to think of the kind of information that a new Maemo developer would need in order to start developing applications on top of Maemo. The idea was not to create a detailed and ready structure for Harmattan, but more to get a first draft of ideal content that would be needed.

The next step is to continue the planning in Wiki + in a new Talk thread. I'll be posting the links here as soon as I've found appropriate places for them. :)

Re: Documentation hackfest in Barcelona
 

Hey everyone! Big thanks from me too, for the excellent input and ideas and for your enthusiasm. It was a great introduction to community working, plus one of the finer doc architecture workshops I've ever participated in.

Good company at dinners was highly appreciated too, especially that very small intimate dinner of 19 people we had on Saturday =8-)

Re: Documentation hackfest in Barcelona
 

Hi Titta!

I have put my notes from the session in the wiki, and it would be great if we could also gather your notes, and the notes/recollections of Ryan, Kathy, David, Daniel and others who took part.

I also moved the TOC to its own page: http://wiki.maemo.org/Developer_Guide_table_of_contents It should get linked from somewhere other than the documentation summit page. Not sure where...

Thanks,
Dave.