Improve documentation

I think the documentation could be improved, I'm using your boilerplate REST API and this (great) module is rather confusing to me. I think what it really lacks is a small explanation about the motivation and some example implementing models as well. I would happily do it but I don't really understand it fully. Is there any chance you can give a little more details in general? Also, an example how models would look like will be helpful as well. I hope I'm not asking too much :P but I did try to dig into the code, and still quite complicated for me.

Thank you!