[maemo-developers] A proper home page in maemo.org with help wiki for each app in Extras

[From: Floriano Scioscia]

This is a good idea for optional in-depth software documentation, like in
your case, or power-user "tips and tricks", like the configuration database
that is being collectively built for Dexter text-tv reader on
http://wiki.maemo.org/Dexter .

However, basic help should stay on the device IMHO. As others pointed out,
we cannot assume the user device is always online.

Furthermore, managing localization would be more complicated. One big Wiki
page for all languages would be confusing, and several Wiki pages for
different languages can potentially lead to mis-aligned information,
particularly if users contribute to the Wiki.


> From: "Sascha Mäkelä" <sascha.makela at gmail.com>
> To: maemo-developers <maemo-developers at maemo.org>
> Date: Fri, 12 Feb 2010 22:05:55 +0200
> Subject: A proper home page in maemo.org with help wiki for each app in
> Extras
> While writing help files for my current project, I came to a conclusion
> that it would be easier to have the app simply point to a wiki page. This
> way a new version of the app would not be needed for changes/corrections in
> the documentation.
>
> Now since we already have a Downloads page in maemo.org for all the apps
> in Extras, why not add a proper wiki for them too. This could be optional,
> of course. But I would see this as a good way of having
> consistent documentation for apps in Extras.
>
> While we are on the subject of a home page for each app, let me bring up
> the donate button again. This would be an easy and consistent place to put
> it. Again, this would be optional.
>
> What do you think? Could this work or am I completely misguided here?
>
>
> Cheers,
>
> Sascha
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.maemo.org/pipermail/maemo-developers/attachments/20100213/3ef7a84b/attachment.htm>