[maemo-developers] Maemo Info Center library service released with first set

From: Andrew Flegg andrew at bleb.org
Date: Thu Apr 22 12:44:49 EEST 2010
[I've changed this to go to maemo-developers, where I think it is more
appropriate to be discussed, follow-ups there please]

On Wed, Apr 21, 2010 at 14:09,  <Jarmo.Tikka at nokia.com> wrote:
>From: Andrew Flegg <andrew at bleb.org>
>> One thing I'd like to see is a *definitive* Maemo reference library.
>> Currently, we have docs spread over Forum Nokia, Info Center, the
>> maemo.org wiki - and then there's the docs that are *duplicated* (with
>> slightly different versions) between the various places.
> This new Maemo Info Center library is planned to be THE place to look for
> official Maemo documentation (and Maemo.org wiki will continue to be
> THE place to look for unofficial docs :).

Yeah, and this is the problem. See below...

> I do nto think we have much documentation in Forum Nokia exception
> being some training slideware and Hildon 2.2. UI guides. I have now
> converted all those 4 Hildon 2.2. UI guides into laTex and I will
> publish them shortly in Maemo Info Centeras official documents
> (they will also be available as PDF/HTML downloadables as all
> other Latex docs).

Cool, thanks.

> I was planning to update and release pyMameo documentation in Info Center
> but it was decided last summer (2009) by our product management that we
> do not release Python (pyMaemo) documentation as official documentation.
> So I cannot add Python documents (and I have not even verified do we
> have updated pyMaemo docs for Fremantle available).

This continued separation between "official" and "unofficial" (and
"open"/"closed") doesn't help developers AT ALL.

Why does a developer need to know, or care, whether the framework they
are using is "officially" sanctioned by Nokia, or whether - like
PyMaemo - it's come from a third-party (though one whose bills are
paid for by Nokia)?!

I want to have a single place that I can refer to broad, deep, Maemo
developer documentation. It seems that the Info Center is NOT it,
solely due to the decisions of your product management. So, for me,
it'd be better if someone in the community mirrored its content and
combined it with the documentation for all the other parts of the real
world Maemo development ecosystem.

If you're able, I would strongly encourage you to try and persuade
your product management into changing their mind on this.
Alternatively, if you'd like me - as a representative of the Maemo
community - to talk to them directly, let me know who to chat to.

Thanks in advance,


Andrew Flegg -- mailto:andrew at bleb.org  |  http://www.bleb.org/
Maemo Community Council chair
More information about the maemo-developers mailing list