Django's documentation is indeed terrible for class based views, but I encourage any developers that have had trouble reading through it to just take a look at the source. I found it to be much easier to learn that way.
That's similar to expecting people to read the source code to understand ActiveRecord or something.
This isn't a complaint, except at me. I've promised to update those docs for coming up on a whole year. :P
Here it is, although the code is somewhat mixed with the old, function based, generic views: https://github.com/django/django/tree/master/django/views/ge...