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...
1- https://github.com/tomchristie/django-rest-framework/blob/ma...
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