[Vala] Examples in documentation

["Gilzad Hamuni" <gilli4 gmx net>]

Hi all,

maybe it's already there and I missed to see it. Is it possible to have some account on an existing 
valadoc-page, so one could add code-examples online rather than working with the markup locally?


Knowing that vala is still evolving, I'm facing one issue that probably could be solved rapidly.

Except of the given tutorials, if someone wants to implement some feature in his application, he either has to

1) guess how he'd use the vala bindings (requires firm experience with glib) or

2) he has to derive the vala-code from some existing C-code, that is using the same library or

3) crawl through some existing vala-projects that would offer an example, somewhere deep inside their source.


Now, once a dev has achieved to have some working code, he might want to share this as an example, so others 
will quickly find out how to use function X from vapi Y.

Wouldn't it boost vala's easy-to-efficient-ratio, if code-examples were attached to the documentation (like 
on msdn or php.net)? Maybe it could be some great advertising, too "Wow, that's just a three-liner!".


Sorry if this has been discussed before, I couldn't find anything related after a quick search.

Best,

Gilzad