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

From: Ryan Abel rabelg5 at gmail.com
Date: Fri Feb 12 23:16:59 EET 2010
On Feb 12, 2010, at 4:12 PM, Ajai Khattri wrote:

> On Fri, 12 Feb 2010, Sascha Mäkelä wrote:
> 
>> 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.
> 
> What about providing the help as a separate package? That way, you can 
> distribute help updates any time you like. You could also make it a 
> dependency of your app to ensure it always gets installed alongside your 
> app.

This isn't really any easier than bundling the docs with the application package itself and marginally more complicated for both the developer and the user. If the docs package is in user/*, then it's cluttering up the application manager and you need twice the amount of effort to get it promoted to Extras. If it's not in user/*, then the user has yet another invisible package sucking up space.

I don't see any reason why we couldn't have a Documentation field on the Downloads page linking wherever.
More information about the maemo-developers mailing list