RubyFlow The Ruby and Rails community linklog

×

The Ruby and Rails community linklog

Made a library? Written a blog post? Found a useful tutorial? Share it with the Ruby community here or just enjoy what everyone else has found!

Let there be docs! Generating an OpenAPI schema across the Rails stack

In API development, documentation is often something tackled once the code’s written and tested. There’s a growing movement advocating for a doc-first approach, where specifications come before a single line of code. So, when might an implementation-first approach be preferred?

Read our answer in this new post from Andrey Novikov, and see how to do it with an existing application by leveraging some tools (including Martian tech) in some unexpected ways.

Let there be docs! Generating an OpenAPI schema across the Rails stack</>

Comments

Interesting! I like the way you generate the schemas. You forgot to include OasRails as option :( haha

Post a comment

You can use basic HTML markup (e.g. <a>) or Markdown.

As you are not logged in, you will be
directed via GitHub to signup or sign in