Re: API documentation from introspection data



On 02/23/2012 09:27 PM, Alberto Ruiz wrote:
Well, this is not quite true Stefan,

Right now if you want to contribute to the docs you have to do quite a bit of work (git+bugzilla workflow), even if you do this everyday, it can be quite annoying and distracting to stop everything that you are doing to ammend documentation (opening a bug request, describing it, coming up with the patch, uploading it).

My intention with the web interface is to enable a contribution queue that people can edit and submit inline that doesn't require any of this and that the maintainer can review once in a while.
Hi, I'd love to have a webapp. That is one thing I like in e.g. php online docs. I even proposed that in the past as a gsoc project (see https://live.gnome.org/DocumentationProject/GtkDocFuture#live_editing).

Stefan


2012/2/23 Stefan Sauer <ensonic hora-obscura de>
On 02/23/2012 04:18 PM, Shaun McCance wrote:

<snip>
> Honestly, I think all of us (me included) are getting too hung up on
> the tools. What we really need is better writing. No amount of tool
> development is going to save you from a lack of good content.
Agree, but one important part is that the tools are working in a way,
that people to see them as an annoyance and turn it off. gtk-doc has
quite a bit of legacy here unfortunately that is not easy to change :/

Stefan
> --
> Shaun
>
>

_______________________________________________
desktop-devel-list mailing list
desktop-devel-list gnome org
http://mail.gnome.org/mailman/listinfo/desktop-devel-list



--
Cheers,
Alberto Ruiz



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