Re: Documentation

[Colin Walters <walters verbum org>]

On Sat, Feb 1, 2014 at 10:08 AM, Matthias Clasen <matthias clasen gmail com> wrote:

- Make the doc comments more readable by moving from clunky docbook markup

  to markdown. This will help both for reading and updating the documentation in
  the sources, and for limiting the scope of whar our documentation-generating
  tools need to parse when generating online docs.

Interesting.  I'm in favor of Markdown.  But does gtk-doc understand it at all?  

I agree this would be a *really* useful endeavor, I just didn't have the motivation to dive

in and translate Docbook to something else myself, but if we're making a collective push,

that sounds great!

The main issue is then ensuring both gtk-doc and g-ir-doc-tool are onboard.