Re: [Vala] Examples in documentation

[Florian Brosch <flo brosch gmail com>]

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