From Dev.to
API documentation examples and how to rewrite unclear endpoint docs
Most API docs are written by the people who built the API. That's why they're accurate and still hard to use. The author already knows what a "resource" is, which field is required and why the call re...