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 designed for that > ... > These days non-xml vocabularies for modeling REST apis are more popular. > Each has its own strengths and weaknesses, depending on your needs. >
I've ended up in very similar conclusion :-) I haven't heard about WADL yet, but right now I am investigating ways how to convert Swagger's OpenAPI (subset) to my DocBook structure. Jan --------------------------------------------------------------------- To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org