To be perfectly honest I think the implementation is a lot better than some of the documentation. The tutorials can be pretty confusing or just plain broken for anyone without at least an intermediate proficiency in Django already. Perhaps the documentation should have messages recommending that developers get good at Django first.

Most of my experience with it has been great though, it's a very well built technology.

For a helpful reference also check out http://cdrf.co

Agreed! The code is lot easier to read than the docs. I generally think of DRF as "that which has to be true so that mixins.py[1] makes sense"

1- https://github.com/tomchristie/django-rest-framework/blob/ma...