Re: API documentation from introspection data

[Tomeu Vizoso <tomeu sugarlabs org>]

On Thu, Feb 23, 2012 at 21:27, Alberto Ruiz <aruiz gnome org> 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.

That sounds great functionality. The webapp will file bugs in BZ and
attach patches to it? Or will maintainers have to go through the
webapp?

Regards,

Tomeu

> 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
>
> _______________________________________________
> desktop-devel-list mailing list
> desktop-devel-list gnome org
> http://mail.gnome.org/mailman/listinfo/desktop-devel-list