Re: [Vala] Examples in documentation

[Brian Duffy <brduffy gmail com>]

Amen, brother! The code examples in the php docs are extremely useful. I
would love to have that capability. I could contribute quite a few snippets
myself, from advice I have gotten from this list. Let's get this done.

It looks like Florian Brosch is the maintaner of Valadoc.org. (*
flo brosch gmail com<https://mail.google.com/mail/?view=cm&fs=1&tf=1&to=flo brosch gmail com>).
Maybe he can comment on this. *
*
*
*I don't know if the php.net docs are moderated or what, but I find them
really helpful. *


On Thu, Nov 8, 2012 at 7:43 AM, Gilzad Hamuni <gilli4 gmx net> wrote:

> 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
> _______________________________________________
> vala-list mailing list
> vala-list gnome org
> https://mail.gnome.org/mailman/listinfo/vala-list



-- 
Duff