Victor, This is an area where I've done some work, though there is still much to do.
I started with https://code.djangoproject.com/ticket/16807 at the sprints, and need to wrap that up. As far as an outline of modular, relatively atomic changes to the docs that would be good to see: * The above work on 16807 split into 2 parts, some integrated into an revamped introduction to views, and more technical bits into a CBV specific doc. This involves reworking the doc that introduce the very concept of views, something that introduces the view contract, function based views, then CBV. * I've submitted an alternate/additional index to the reference material that I think is clearer for users of the generic views in: https://code.djangoproject.com/ticket/17378 * It would be great to see a CBV cookbook full of examples such as auth login_required, Forms, etc There are several CBV tickets I'm hoping to see closed for 1.4, which while not documentation, will hopefully make CBV use a little clearer: Tobias and I worked on https://code.djangoproject.com/ticket/16074 and it is close to done https://code.djangoproject.com/ticket/16744 follows easily after that lands and then https://code.djangoproject.com/ticket/17228 and https://code.djangoproject.com/ticket/17381 those all help clean up the context story It would be nice to see some resolution to https://code.djangoproject.com/ticket/14512, I think the mixin approach is the best, but not sure the work can be done to convert the rest of the stock decorators in time for 1.4? Victor - are you interested in helping with this? Anyone else? -Preston On Dec 11, 10:27 pm, Victor Hooi <victorh...@gmail.com> wrote: > Hi, > > I might be stating the obvious, but the documentation for the newer CBV's > is a little sparse: > > There's simple examples: > > https://docs.djangoproject.com/en/1.3/topics/class-based-views/ > > As well as a generic list of mix-ins and in-built views: > > https://docs.djangoproject.com/en/1.3/ref/class-based-views/ > > However, there's no fuller examples, or best practice notes. There's no > explanation of any of the views beyond TemplateView, ListView and > DetailView (e.g. UpdateView, DeleteView, RedirectView, or any of the > date-based CBVs). > > Sure, if you trawl around, you'll find some examples: > > https://gist.github.com/1275204https://groups.google.com/d/topic/django-users/HdYBkywNeII/discussionhttp://stackoverflow.com/questions/5899810/class-based-view-extending... > > However, it would be awesome if there were examples in the official Django > documentation that set out once and for all how to use these new-fangled > CBV's. I would love to use them more extensively, but it seems like I'd > need to spend hours on Google to work out all the nuances. > > Is this something that could be resolved before pushing out Django 1.4, or > is it much lower on the list of priorities? > > Cheers, > Victor -- You received this message because you are subscribed to the Google Groups "Django developers" group. To post to this group, send email to django-developers@googlegroups.com. To unsubscribe from this group, send email to django-developers+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/django-developers?hl=en.
