The django docs arn't as good as they're made out to be, at least not any more. The major problem is they're lagging behind at this point, in both using the new core features such as class based views, and in best practices, such as the tutorial teaching reusable apps.

the core devs have said this themselves though on stage at cons, so i'm sure it'll get fixed at some point.