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 ) ¶
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?
- To make the multiple branches of form view logic more explicit. What methods get called when there is a GET? What about a POST?
- 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 , 10 years ago
comment:2 by , 10 years ago
Cc: | added |
---|
comment:3 by , 10 years ago
Triage Stage: | Unreviewed → Accepted |
---|
An example "Method Flowchart" is here: https://docs.djangoproject.com/en/dev/ref/class-based-views/generic-display/#listview.
comment:4 by , 9 years ago
Description: | modified (diff) |
---|
comment:5 by , 4 months ago
Cc: | added |
---|---|
Owner: | changed from | to
Status: | new → assigned |
comment:6 by , 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.
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)