Re: API documentation from introspection data

[Alberto Ruiz <aruiz gnome org>]

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.

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