Clearing up the documentation with practical API examples

[sidneydobber]

I have a problem, but I don't know if it's an issue though. I have a relational model which has 'POST', 'PUT' and 'DELETE' functionality. It also has a relation pointing to it that is used by another part of the application. The problem is that the 'POST' reverts to a 'PUT' because the 'id' attribute contains a collection that get's added by the other model. When I remove the reverse relation all works fine.

UPDATE TO ORIGINAL QUESTION:
The problem was solved, but after a little dialogue we stated that the documentation could be more practical and clear. As an example the implementation of a specific API and not just manually created collections, because this was where things got unclear for me. I will try and setup up a JSFiddle and a list with issues that aren't clear from the docs.