Re: [Vala] Examples in documentation



Hey Brian,

[1] > - Downvoted comments are hidden
[2] > - People can earn badges (like Novice, Guru, etc.)
     >    to attract people to comment more
[3] > - Comments to comments, so that main comments are
      >   relative to documenting stuff and not only replying to
      >   people.

[1] Sorted by votes
[2] Not planned
[3] Already implemented

ETA -> December

On Fri, Nov 9, 2012 at 3:11 AM, Brian Duffy <brduffy gmail com> wrote:
Very much looking forward to this feature! What do you think of Luca's
suggestions? ETA?


On Thu, Nov 8, 2012 at 8:33 PM, Florian Brosch <flo brosch gmail com> wrote:

Hey guys,

I'm already working on a comment system:

http://unstable.valadoc.org/


On Thu, Nov 8, 2012 at 1:43 PM, 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
_______________________________________________
vala-list mailing list
vala-list gnome org
https://mail.gnome.org/mailman/listinfo/vala-list




--
Duff



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]