What is the deal with the server that valadoc.org runs on? Would the comment system need to be based on flat files or is their a db (mysql, sqlite, etc) available?
On Fri, Nov 9, 2012 at 9:24 AM, Brian Duffy <[email protected]> wrote: > I think it is things like good code examples, good documentation, and good > tools that will grow Vala's community. This effort (comments in valadoc) > and Valama are two steps in the right direction. I hope they work out. The > thing I really like about the comments is that it provides a potential > source of examples for all of the great libraries accessible by Vala > (clutter, gtk, sqlite, etc). > > > > On Fri, Nov 9, 2012 at 8:23 AM, 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 >>> >>> >> > > > -- > Duff > -- Duff
_______________________________________________ vala-list mailing list [email protected] https://mail.gnome.org/mailman/listinfo/vala-list
