Document why/when of class-based views
|Reported by:||Steven Cummings||Owned by:||Steven Cummings|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||yes|
The documentation for class-based views is getting better, but it's missing an introductory discussion of why and when you use them. Specifically, the goals of such a narrative should be:
- Practical context for choosing CBVs vs. FBVs
- Usage patterns appropriate to class-based views
- List of helpful, concrete decision points from the above discussion
Hopefully this can be something that people point to for diffusing absolutist arguments for CBVs or FBVs, and the community can start to agree when each is right (a bit of a grandiose goal, yes, but it should be possible).
New documentation that may arise out of the above needs:
- How to test class-based views (and comparison with testing FBVs)
Ticket #19227 aims to provide visualizations code flows in class-based views and so may interact with some of the changes made on this ticket.
Change History (12)
comment:7 Changed 4 years ago by
|Owner:||changed from nobody to Steven Cummings|
|Status:||new → assigned|