Re: API documentation from introspection data

2012-02-23 Thread Shaun McCance
On Tue, 2012-02-21 at 17:08 +0100, Stefan Sauer wrote: On 02/19/2012 03:41 PM, Shaun McCance wrote: On Sun, 2012-02-19 at 12:48 +0100, Stefan Sauer wrote: Just one thought. If people work on a next generation doc tool to take over from gtk-doc, please consider to do it without docbook xml

Re: API documentation from introspection data

2012-02-23 Thread Stefan Sauer
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

Re: API documentation from introspection data

2012-02-23 Thread Martin Robinson
On Thu, Feb 23, 2012 at 11:15 AM, Stefan Sauer enso...@hora-obscura.de wrote: 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

Re: API documentation from introspection data

2012-02-23 Thread Alberto Ruiz
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

Re: API documentation from introspection data

2012-02-23 Thread Tomeu Vizoso
On Thu, Feb 23, 2012 at 21:27, Alberto Ruiz ar...@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