On Sat, Apr 10, 2010 at 08:34, Dave Neary <[email protected]> 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:[email protected] | http://www.bleb.org/
Maemo Community Council chair
_______________________________________________
maemo-community mailing list
[email protected]
https://lists.maemo.org/mailman/listinfo/maemo-community
