Hey Steven, It is usually less painful to write a data extractor. However, I'm personally not planning to work on non-gnome-docs at all.
On Fri, Nov 9, 2012 at 2:23 PM, Steven Oliver <[email protected]> wrote: > My biggest complaint with vala's docs isn't valadoc, it does well enough for > what it is. Also, the comment feature sounds nice as long as the community > takes care of it (eg Wikipedia) but I have seen plenty of wikis that aren't > taken care of too. I worry vala's active community as this point is still > too small for that though. There's only one way to find out though! > > My biggest complaint is more the complete lack of valadoc compatible > comments in the code itself. I would rather see people submit patches that > add valadoc comments to code; _especially_ to the vapis. For example Sqlite > is completely devoid of valadoc comments in it's vapi. > > http://unstable.valadoc.org/#!api=sqlite3/Sqlite > > I looked up the vapi, it's not difficult to figure out: > > http://git.gnome.org/browse/vala/tree/vapi/sqlite3.vapi > > Steven N. Oliver > > > > On Thu, Nov 8, 2012 at 9:11 PM, Brian Duffy <[email protected]> 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 <[email protected]> >> 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 <[email protected]> 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 >> > > [email protected] >> > > https://mail.gnome.org/mailman/listinfo/vala-list >> > _______________________________________________ >> > vala-list mailing list >> > [email protected] >> > https://mail.gnome.org/mailman/listinfo/vala-list >> > >> >> >> >> -- >> Duff >> >> _______________________________________________ >> vala-list mailing list >> [email protected] >> https://mail.gnome.org/mailman/listinfo/vala-list >> > _______________________________________________ vala-list mailing list [email protected] https://mail.gnome.org/mailman/listinfo/vala-list
