Re: Asciidoctor (was: Structured stuff for the beginner)

[Chris Despopoulos <despopoulos_chriss -at- yahoo -dot- com>]

Very interesting stuff, and Swagger2Markup looks very cool. One thing I can't help to notice... It looks like you don't get the TRY ME capabilities that SwaggerUI gives you. Is that true, or am I misreading this? 

The thing I'm trying to figure out is how to convert Swagger to DITA on the one hand -- that would give you merged documentation plus total control of PDF or other static outputs. On the other hand, I'd like to extend Swagger to include IDs for authored content, and then get the SwaggerUI to display that. Then you can merge authored content with the TRY ME capability. I'm guessing that Swagger2Markup comes close to the first (you could go from Markup to XDITA pretty easily, and oXygen already knows how to include Markup in DITA). But the second is still not there???
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives