[maemo-community] Start of April_10 sprint: your action required

[From: Andrew Flegg]

On Sat, Apr 10, 2010 at 08:34, Dave Neary <dneary at maemo.org> wrote:
>>
>> The only big task I can really think of is really sorting out the
>> various Maemo docs, reference materials and so on across different
>> versions. Too often I'll Google for something and end up in Maemo 3.x
>> documentation. I know that's not very specific :)
>
> Do you have any suggestions for models we should follow? Can we, for
> example, dump Maemo 3.x docs completely at this stage if they're no
> longer relevant for Maemo >= 4?

The best example I can come up with is Sun's Javadoc (the complete API
documentation for the Java library), plus all the associated
tutorials.

Example problems (OTTOMH):

  * Maemo 3 had Python documentation, but the canonical place for that
    now is http://pymaemo.garage.maemo.org/
  * Maemo 4 had lots of PDF documentation so isn't easy to search
  * Maemo 5 has docs spread across the wiki (both current and archive),
    Forum Nokia and so on.

Now, I don't know how to solve this problem; perhaps one task could be
to look at what other projects do about old API & reference
documentation and come up with a strategy for Maemo? (Assuming we
don't have one already :-))

Cheers,

Andrew

-- 
Andrew Flegg -- mailto:andrew at bleb.org  |  http://www.bleb.org/
Maemo Community Council chair