[maemo-developers] Maemo documentation - feedback time is now

[From: Mike Morrison]

Here are a few things I've been struggling with lately:

The porting guide, the 'writing a new application' document, and the
tutorial (and probably others) have a lot of overlap. Maybe they could be
merged or the redundant bits of information could be in one place and these
docs could link to it?

The documentation on .desktop/.service files needs improvement as the
examples in the docs do not work. I wasted several hours figuring out how to
set it up properly (later I saw a bug in bugzilla about this,
https://maemo.org/bugzilla/show_bug.cgi?id=602).

I couldn't find any documentation about mime types / file associations. Is
it even possible to associate a mime type with a different application or
does the file manager always just use the default? And how does the file
manager pass arguments  (the files to load) through to the associated
application (if the associated app has a .service file)?

Documentation on icons is lacking. Why isn't the libossomime in the api
docs? I would also like to use some of the "stock" hildon icons in my app
but there is no HILDON_STOCK #defines (like in gtk+). Why not?

There is no document about thumbnail caching, but I see that
~/.thumbnails/osso has 80x80 thumbnails. Should that be in a document
somewhere?

I have probably had other issues with the docs, but that's all I can
remember right now.

Mike


On 3/28/07, Jukka-Pekka.Iivonen at nokia.com < Jukka-Pekka.Iivonen at nokia.com>
wrote:
>
>  Hi,
>
> Maemo tutorial and how-to documention are in http://maemo.org/platform/docs/how-to.html
> . There exists API documentation as well on http://maemo.org/platform/docs/api-index.html
> . So the question is are they good enough, what could be improved, any
> bugs, two few examples or specs, wrong format, or other things that are on
> your way to block hacking on some area or on a particular topic? Thanks,
> already in advance!
>
> Regards,
> JP
>
> _______________________________________________
> maemo-developers mailing list
> maemo-developers at maemo.org
> https://maemo.org/mailman/listinfo/maemo-developers
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.maemo.org/pipermail/maemo-developers/attachments/20070330/830988f2/attachment.htm