Ruby on Rails Tuesday, June 13, 2017

We're working for some time on tool that makes a process of API documentation easier. For now, we've been using apiary, raml, swagger. Unfortunately, they always required constant attention just to keep them up to date. Under time pressure documentation was the first candidate to abandon.

Our project website is Its purpose is automatic generation of API documentation. We allow you to manage its state and keep your documentation up to date. Watchdocs uses dedicated middleware that records, sanitises JSON requests/responses and sends them for further analysis. This allows us to enable it for any environment that you'd like to be a source of truth like tests on continuous integration or your staging server traffic.

Application consists of 4 parts:
- middleware (dedicated for given framework) that records and sends requests
- sinatra aplication that analyses incoming data on our side
- ruby on rails + react on editor side where you can see your documentation

We are still at early days so I can't stress enough how valuable your feedback is to us. Don't hesitate to get in touch if you need any help!

You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group.
To unsubscribe from this group and stop receiving emails from it, send an email to
To post to this group, send email to
To view this discussion on the web visit
For more options, visit

No comments:

Post a Comment