Мы уже писали про подход documentation-first, когда о документации заботятся до того, как писать код. Но мы же Марсиане, мы попробуем и прямо противоположное. Итак, что там с implementation-first? Заодно покажем, как это сделать, используя подручные гемы немного не по назначению. Прямо как в «очумелых ручках»!

https://evilmartians.com/chronicles/let-there-be-docs-generating-openapi-schema-across-rails-stack