[xquery-talk] Xquery and API documentation
John.Snelson at marklogic.com
Wed Apr 24 05:57:55 PDT 2013
Try xquerydoc, which can extract XQDoc comments and style them in HTML and markdown. It's written in pure XQuery 1.0, with a small amount of XProc to drive the initial execution.
On 24 Apr 2013, at 13:40, Jakob Fix <jakob.fix at gmail.com>
> I'm looking for ways to generate API documentation from our Xquery code. Of course, there is Xqdoc, but I'm looking to get something that is a) a bit better-looking and more importantly, b) usable by the developer who wants to try out the API.
> I've been looking at Swagger  which seems to do what I want. It expects a JSON file that would need to be generated from the Xquery code. I think I remember Adam Retter giving a talk on how to use 3.0 annotations for defining the API in Prague a couple of years ago.
> Are there already efforts underway to get something like this going?
> I would be most interested,
>  https://developers.helloreverb.com/swagger/
> talk at x-query.com
More information about the talk