Convert Swagger REST doc to AsciiDoc

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

Convert Swagger REST doc to AsciiDoc

RobWin
Hello,

i'm currently developing a Swagger to AsciiDoc converter. It takes an swagger.json or swagger.yaml as an input file and generates an AsciiDoc file. The primary goal of this project is to simplify the documentation of RESTful APIs. The result is intended to be an easy-to-read, on- and offline user guide, comparable to GitHub’s API documentation.

See https://github.com/RobWin/swagger2asciidoc

Now my question. I developed my own AciiDocBuilder to dass the Generation oft AsciiDoc files. But I wonder, whether  the official Asciidoctorj project has already one?
Otherwhise I could extract and contribute the Builder to the asciidoctorj project when I'm finished.

Kind regards,

Robert Winkler
Reply | Threaded
Open this post in threaded view
|

Re: Convert Swagger REST doc to AsciiDoc

LightGuardjp
I don't recall this ever being discussed, I don't think it has been done before.

On Thu, Feb 12, 2015 at 10:33 AM, RobWin [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hello,

i'm currently developing a Swagger to AsciiDoc converter. It takes an swagger.json or swagger.yaml as an input file and generates an AsciiDoc file. The primary goal of this project is to simplify the documentation of RESTful APIs. The result is intended to be an easy-to-read, on- and offline user guide, comparable to GitHub’s API documentation.

See https://github.com/RobWin/swagger2asciidoc

Now my question. I developed my own AciiDocBuilder to dass the Generation oft AsciiDoc files. But I wonder, whether  the official Asciidoctorj project has already one?
Otherwhise I could extract and contribute the Builder to the asciidoctorj project when I'm finished.

Kind regards,

Robert Winkler


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Convert-Swagger-REST-doc-to-AsciiDoc-tp2777.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--