Re:Documentation-driven development for APIs
by layla0911 on Monday October 19, 2020 @04:03PM
(#24830338)
Fair, but it seems to be kind of an overkill for simple APIs, specially when it's internal APIs developed by a team that works well together.
[ Parent
| on HN ]
Re:Documentation-driven development for APIs
by save_ferris on Monday October 19, 2020 @04:20PM
(#24830531)
I recently joined a company that builds all of its APIs this way, and I'm not looking back. It's so much easier to communicate across teams and tech stacks when we can send them a PR with a proposed endpoint contract. Plus, people always come and go and good API docs can help a new developer ramp up considerably faster.