id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
35682	Clarify Base<FOO>View usage in docstrings.	Jesús Leganés-Combarro	YashRaj1506	"At https://github.com/django/django/blob/a57596e443ecb67140e1a9fc0f0e87446b2d0174/django/views/generic/list.py#L175, `BaseListView.get()` method is calling to `self.render_to_response(context)` method. Fact is, I have searched in all the `BaseListView` ancestor classes (`MultipleObjectMixin`, `ContextMixin` and `View`) and was not able to find any reference to the `render_to_response()` method, both in the documentation or the code itself. The only place I have been able to find it implemented is in the `TemplateResponseMixin` class, that's templates oriented, and it's only related to `BaseListView` because both classes are ancestors of `ListView`.

In its current state, using `BaseListView` class without overriding the `BaseListView.get()` method (that already implements a proper handler for HTTP `GET` method, so overriding would not be needed) would crash because `render_to_response()` method can't be found. One solution would be to add `render_to_response()` as an abstract method, and add it on the documentation forcing to be implemented in a child class, but `render_to_response()` feels to be too much related to templates, and was not able to find any other rendering related function in `View` or other ancestor class of `BaseListView`... Another maybe better solution would be to move `BaseListView.get()` method to `ListView.get()`, left ing `BaseListView` empty the same way that `ListView` currently is, or just with a `get_context_data()` method to include the checking if list is empty like a validation, but that last ones would be backward incompatibles... Is there any other better solution for this?"	Cleanup/optimization	closed	Generic views	5.1	Normal	fixed		Jesús Leganés-Combarro Clifford Gama	Ready for checkin	1	0	0	0	1	0