Have anyone here had a problem with keeping your APIs documentation up to date?
We’ve been using various tools over the years, including Swagger or Apiary, but we’ve always struggled with consistency and the reality is, documentation has always been neglected.
So we’ve decided to build a rails middleware that records requests and monitors changes in API. We’ve started using it for our projects, and recently we’ve decided that we should share it with the Rails community, so we’re now building a simple front-end app around it. You can try it at http://watchdocs.io
I would love to hear whether you guys find it worth to pursue that problem. Thanks in advance!