Thread
:
[Brainstorm 2010] Wiki
View Single Post
Jaffa
2010-05-19 , 12:49
Posts: 2,535 | Thanked: 6,681 times | Joined on Mar 2008 @ UK
#
2
It's not wiki-related, but more documentation related:
Let's sort out the various Maemo docs, reference materials and so on across different versions.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 the wiki ([s]http://pymaemo.garage.maemo.org/[s])
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 tutorials and the Info Center.
As a developer, I want a library/bookshelf I can go to and see the behaviour of
HildonWindow
, it's API in Python and click through to the inherited behaviour from Gtk+.
Currently, I end up flipping between the wiki, pymaemo.garage.maemo.org and online references which don't quite match our Gtk+ version.
The problem "should" get better with Qt, but we're not a Qt-based development community (primarily), we're Gtk+. And Qt specifics for accessing Maemo 5 stuff should be alongside the Qt general docs on maemo.org.
__________________
Andrew Flegg
-- mailto:andrew@bleb.org |
http://www.bleb.org
Quote & Reply
|
The Following 3 Users Say Thank You to Jaffa For This Useful Post:
GeneralAntilles
,
javispedro
,
qole
Jaffa
View Public Profile
Send a private message to Jaffa
Visit Jaffa's homepage!
Find all posts by Jaffa