В новом посте бэкенд-инженер Святослав Крюков рассматривает разные подходы к документации API и чем может быть полезен один из них, documentation-first. А еще дает советы, как перейти на подобный подход и о новом Ruby-геме, который в этом поможет.
https://evilmartians.com/chronicles/let-there-be-docs-a-documentation-first-approach-to-rails-api-development
>>Click here to continue<<