How improve GNOME Documentation

Here I will try to collect some ideas about GNOME documentation (I'll focus in technical documentation) from a newbie point of view

I think that should be more easy make suggestions/correction to the Gnome Documentation (in special the API/reference documentation)

Some good examples are:

Valadoc.org project: you can contribute "online" to improve the documentation of Vala language. For example: http://www.valadoc.org/?pkg=glib-2.0&action=edit
New Django book: You can do comments and suggestion on each paragraph of the book.
Monodoc: you can edit the reference documentation and send it upstream, all without exit the program. I also send a bug report to implement this on devhelp: 580246

Also there are some related work here: