[maemo-developers] Request: Tutorials & use-cases for documentation

[From: Quim Gil]

ext Gary Birkett wrote:
> excellent idea!
> 
> try to allow the examples to come from different toolkits.
> there is more than one method of doing everything.
> if the same question is answered in both gtk and qt for instance,
> it will help existing developers to adapt and see the differences in
> approaching problems.

There is a good point behind this which is how to cross use cases with
technologies. I don't think the answer is to aim to cover all
technologies equally for each use case e.g.

How to get a nice % progress bar
- In Web Runtime follow these steps.
- In Qt follow these other steps.
- In GTK+ you would do it this way.
- In PyMaemo.......

I guess developers first make a decision about the toolkit they are
going to use and then expect to find documentation specific to that
toolkit. Cross-links are nice but that's it.

So let's assume that use cases will concentrate on a specific toolkits.
The ones we will push will be based on the toolkits officially
supported, then others can add the "translations" to their preferred
community supported toolkit if they wish.

Looking at http://wiki.maemo.org/Documentation/Use_case_template it is
not clear whether such links should be placed in the intro, Related
APIs... Tips & Tricks would force the template too much.

-- 
Quim Gil
open source advocate
Maemo Devices @ Nokia