Opened 10 years ago

Last modified 4 weeks ago

#24162 assigned New feature

"Method Flowchart" for all CB(G)V documentation pages

Reported by: Ivan Ven Osdel Owned by: Clifford Gama
Component: Documentation Version: 1.7
Severity: Normal Keywords: CBV CBGV method flowchart
Cc: tomas.ehrlich@…, Clifford Gama Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no
Pull Requests:How to create a pull request

Description (last modified by Ivan Ven Osdel)

First off, to whoever had the idea and put in the effort to add the "Method Flowchart" to some of the CBV and CBGV doc pages, thank you, thank you, thank you. So helpful.

Example "Method Flowchart": ​https://docs.djangoproject.com/en/dev/ref/class-based-views/generic-display/#listview

So naturally I would love to see the feature on all of the CB(G)V pages, particularly those with a form as they are more complicated.

Why is this necessary?

  1. To make the multiple branches of form view logic more explicit. What methods get called when there is a GET? What about a POST?
  1. To gain all the advantages that the "Method Flow" chart has provided to the other views. For me it has been primarily helpful for understanding and figuring out how to avoid duplicate queries.

Moved from comment on: ticket:20608

According to the ticket's flags, the next step(s) to move this issue forward are:

  • To provide a patch by sending a pull request. Claim the ticket when you start working so that someone else doesn't duplicate effort. Before sending a pull request, review your work against the patch review checklist. Check the "Has patch" flag on the ticket after sending a pull request and include a link to the pull request in the ticket comment when making that update. The usual format is: [https://github.com/django/django/pull/#### PR].

Change History (6)

comment:1 by Tomáš Ehrlich, 10 years ago

I'm a bit confused by your description (I've never heard of "Method flowchart"), but if you want to see whole ancestors tree with all methods (and code snippets!), have a look at http://ccbv.co.uk

The question whether this should be included in docs remains. Personally I use http://ccbv.co.uk a lot. Without this site the CBV would be very hard to customize (yes, I still can browse the source code, but it isn't definitely as convenient as http://ccbv.co.uk)

comment:2 by Tomáš Ehrlich, 10 years ago

Cc: tomas.ehrlich@… added

comment:3 by Tim Graham, 10 years ago

Triage Stage: UnreviewedAccepted

comment:4 by Ivan Ven Osdel, 9 years ago

Description: modified (diff)

comment:5 by Clifford Gama, 4 months ago

Cc: Clifford Gama added
Owner: changed from nobody to Clifford Gama
Status: newassigned

comment:6 by Clifford Gama, 4 weeks ago

I think this ticket may have to be addressed along with #19227 (Reorganize method flowchart for class based generic views to tree), as the method flowcharts would be more accurate and helpful in tree form as opposed to current lists.

Note: See TracTickets for help on using tickets.
Back to Top