Skip to content

Mermade/oa2s-comparison

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

oa2s-comparison

A comparison of various OpenApi(Swagger)-to-Slate markdown tools.

Currently compared are:

To see the output using each tool's defaults using the Swagger petstore demo, see here.

Disclaimer: the author of this repository and the blog post discussing the comparison is also the author of widdershins, and shins, the Node.js port of Slate used here to convert each tool's Slate markdown into HTML.

Notes

Because shins uses markdown-it as it's markdown processor, there may be differences in the rendered HTML compared to that produced by Ruby Slate.

Each tool may be optimised for a particular Slate CSS theme. This is not taken into account here.

Only the example petstore.json has been used so far to compare each tool, which may not demonstrate all features to best effect.

Related, but non-Slate-based tools