View Single Post
Jaffa's Avatar
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
 

The Following 3 Users Say Thank You to Jaffa For This Useful Post: