[xquery-talk] Xquery and API documentation

John Snelson 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>

> Hi,
> 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 [1] 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,
> Jakob.
> [1] https://developers.helloreverb.com/swagger/
> _______________________________________________
> talk at x-query.com
> http://x-query.com/mailman/listinfo/talk

More information about the talk mailing list