[maemo-developers] Upcoming new maemo documentation and an introduction

[From: David Hazel]

I think the section on Development Environment should cover the following,
in addition to the things that are listed:
- Suggestions of IDEs to use (I use Geany, but maybe there are better ones)
- Tools that are available for creating GUIs (I don't know any, so I've had
to work out the positioning of widgets by a combination of hand calculation
and trial-and-error).
- Limitations of the emulator that runs under Scratchbox (e.g. it doesn't
seem to include a Browser or a File Manager, so any applications that
interact with those can't be fully tested except on the device itself)
- The section on "Packaging, deploying and distributing" needs to be as
self-contained as possible, with a proper description of how it all works
and what is necessary. Examples are fine, but an up-front description of the
principles will avoid the kind of runaround I'm having with trying to
understand things like Automake which really aren't anything to do with
Debian packages.

Also, even though you say this is aimed at people with GNU/Linux experience,
the section on Porting Software might benefit from some hints for people
wanting to port Windows Mobile applications.

Finally, I hope the sections on the architecture, system services and other
system software will include information on the APIs and the C header files
needed. I spent a lot of time simply working out what calls I needed and
where they were declared.


David Hazel

> -----Original Message-----
> From: maemo-developers-bounces at maemo.org
> [mailto:maemo-developers-bounces at maemo.org]On Behalf Of Juha Tukkinen
> Sent: 26 September 2007 10:57
> To: maemo-developers at maemo.org
> Subject: Upcoming new maemo documentation and an introduction
>
>
> Hello maemo developers!
>
> Information for you in advance: a completely new maemo
> document intended
> for new maemo developers, "Maemo 4 Quick Start Guide" will be
> out in the
> near future. The purpose of the guide is to be a starting point for
> developing maemo applications for people with basic GNU/Linux
> software
> development background. No previous embedded or maemo programming
> knowledge is required.
> I would appreciate any feedback on its table of contents [1]
> right now.
> Is something crucial completely missing from your point of view?
>
> Also, revised and supplemented maemo Chinook documentation
> (how-tos and
> a tutorial) will be released in the very near future.
>
> I joined the OSSO team in Nokia this summer to help spread the maemo
> message, hence the memorable title ;) Amongst other things,
> I'm involved
> with maemo documentation and the processes and tools of getting the
> documentation better. A task I will need your help and ideas.
>
>  - Juha T. / jtukkine
>
> P.S. Greetings to all the nice people I met at GUADEC'07!
>
> [1]
> http://maemo4beginners.garage.maemo.org/maemo-quick-start-toc-
20070925.pdf

--
__________________________________________________________
Maemo Evangelist                   juha.tukkinen at nokia.com
Open Source Software Operations                 Multimedia

_______________________________________________
maemo-developers mailing list
maemo-developers at maemo.org
https://lists.maemo.org/mailman/listinfo/maemo-developers