On Mon, 2015-02-02 at 16:51 +0000, Philip Withnall wrote:
Documentation is generated from C comments as at the moment, reformatted, uploaded to developer.gnome.org, and then some kind of online interface can be used to edit the documentation (and possibly add comments to it) with instant gratification. That’s what the first few points are about. There are no requirements covering how these online edits would be fed back into the C comments, but presumably that would happen somehow. The fact that there are no requirements means nobody in the hackfest discussion had strong feelings about how it should be done.
A long time ago, Danilo Segan kind of had this working at least for DocBook as a Google Summer of Code project: https://wiki.gnome.org/Attic/LiveDocumentationEditing -- Murray Cumming murrayc murrayc com www.murrayc.com
Attachment:
signature.asc
Description: This is a digitally signed message part