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
28581	Pagination topic docs need a little restructuring	luto	luto	"During the Write The Docs conference I came a cross a few issues with the [https://docs.djangoproject.com/en/dev/topics/pagination/ pagination topic documentation]. The content itself is great, but I think a little restructuring could make it even better. Together with Daniele, we came with the following changes:

* the topic page contains a full class reference to the `Paginator` class as well as some helper classes. This should move to a new reference page.
* most developers will use a views `paginate_by` instead of the `Paginator` class directly. This is documented in reference as part of [https://docs.djangoproject.com/en/dev/ref/class-based-views/mixins-multiple-object/ Multiple object mixins] as well as a very specific example in [https://docs.djangoproject.com/en/dev/topics/class-based-views/mixins/#using-singleobjectmixin-with-listview Class Based Views]. But there is no straight-forward example anywhere. The new page should provide one and explain the behavior on a higher level.

Please note that this is my very first issue and pull request to django. If any part of this does not comply with the way you usually do things, just let me know and I'll happily adapt :)"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Accepted	1	0	0	0	1	0