Re:Ask HN: What's the best way to write an API spec?
by bike_index on Monday January 19, 2015 @03:15PM
(#8913806)
We've been working on updating our API to V2[1], and decided to go with grape because it automatically generates documentation via grape-swagger[2].
Initially we considered Apiary, but we wanted more flexibility and preferred to host things ourselves. And the fact that our documentation is generated automatically from the code via grape-swagger is a game changer.
Initially we considered Apiary, but we wanted more flexibility and preferred to host things ourselves. And the fact that our documentation is generated automatically from the code via grape-swagger is a game changer.
[1] https://bikeindex.org/documentation/api_v2
[2] https://github.com/tim-vandecasteele/grape-swagger