I started adding JSON responses to the documentation strings.
Do we want to do it this way, or do you think I should change something?
If you think this is a good way to do it, keep the pull request open and I'll add responses to the other endpoints too.
@rkh your thoughts on this? we really need to improve the docs, I point people to the docs only to have little to show them.
Seems good. Maybe we should send actual models through the API serializers?
@henrikhodne can you rebase, and comment on this, and feel free to merge as well, we need to make some movement on this.
Add a way to add responses to documentation
You can add a predefined JSON response by entering
"json(:resource_name)" in the docstring. This will then be replaced
with the resource with the same name, found in
Add responses to repository endpoints
Rebased. I think I like the idea of running models through the API serializers, I'll look into doing that.
After trying a few things, I decided not to use actual models. Since it'll run on production servers there were all kinds of issues with conflicting with actual entries in the database. This is a good start IMO.