swagger2markup
grape-swagger
swagger2markup | grape-swagger | |
---|---|---|
2 | 1 | |
2,480 | 1,078 | |
0.3% | 0.0% | |
1.8 | 6.8 | |
about 2 years ago | 4 days ago | |
Java | Ruby | |
Apache License 2.0 | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
swagger2markup
-
API documentation platforms/authoring stacks
I'm already up to my elbows in AsciiDoc/Antora building a new online help platform, and I noticed that Swagger2Markup exists. No idea if it's any good, but I might be able to integrate it into my existing workflow and spit out some usable static content at the other end...
-
They must hate the JS part in JSON
There are ways to generate a pdf from an OpenAPI-definition. You could use something like swagger2markup. But be warned that this approach has a pretty limited flexibility, the tools are often badly supported and it may involve a lot of work.
grape-swagger
-
OpenAPI Specification: The Complete Guide
The grape-swagger gem provides an autogenerated documentation for your Grape API- GitHub - ruby-grape/grape-swagger
What are some alternatives?
openapi-generator - OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
Apipie - Ruby on Rails API documentation tool
widdershins - OpenAPI / Swagger, AsyncAPI & Semoasa definitions to (re)Slate compatible markdown
rspec_api_documentation - Automatically generate API documentation from RSpec
kin-openapi - OpenAPI 3.0 (and Swagger v2) implementation for Go (parsing, converting, validation, and more)
YARD - YARD is a Ruby Documentation tool. The Y stands for "Yay!"
archifacts - archifacts is a library to extract your architectural concepts out of your application's code
RDoc - RDoc produces HTML and online documentation for Ruby projects.
toml.io - Source Code for toml.io
Asciidoctor - :gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
schedge - API for NYU's course catalog
GitHub Changelog Generator - Automatically generate change log from your tags, issues, labels and pull requests on GitHub.