Re: [docbook-apps] REST API description

2017-12-07 Thread Dave Pawson
http://vrici.lojban.org/~cowan/XML/tagsoup/#tsaxon is available if you want to use XSLT with an html source. Dave On 7 December 2017 at 21:25, Peter Desjardins wrote: > I'm using NPM Bootprint (https://www.npmjs.com/package/bootprint) to > convert OpenAPI YAML

Re: [docbook-apps] REST API description

2017-12-07 Thread Peter Desjardins
I'm using NPM Bootprint (https://www.npmjs.com/package/bootprint) to convert OpenAPI YAML definititions to HTML. Then I use Jsoup (https://jsoup.org/) to convert the resulting HTML to XHTML. Then I use XSLT to insert the XHTML API documentation into my DocBook webhelp. I'm not too happy about

RE: [docbook-apps] REST API description

2017-12-07 Thread Jan Tosovsky
On 2017-12-07 David Cramer wrote: > On 2017-12-05 Jan Tosovsky wrote: > > Is there any recommended DocBook tag set for describing REST API? > > I don't think DocBook is the right vocabulary for modeling a REST API. > There's an XML schema, WADL (Web Application Description Language) that > is

Re: [docbook-apps] REST API description

2017-12-07 Thread David Cramer
I don't think DocBook is the right vocabulary for modeling a REST API. There's an XML schema, WADL (Web Application Description Language) that is designed for that: https://en.wikipedia.org/wiki/Web_Application_Description_Language I would suggest putting the API specification in WADL and