Opened 18 years ago

Closed 17 years ago

#2603 closed defect (fixed)

Object Pagination is documented on the wrong page.

Reported by: lucasvo@… Owned by: Nick Efford
Component: Documentation Version:
Severity: minor Keywords: sprintsept14
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

The doc which explains the Pagination(http://www.djangoproject.com/documentation/models/pagination/) contains less detail then the generic view(http://www.djangoproject.com/documentation/generic_views/#django-views-generic-list-detail-object-list). But when one needs Pagination one does not always use generic views to this is not a very intuitive place to store the doc. There are several different ways how to solve this problem.

  1. the easiest way: just make a link on the bottom of 29. Object pagination to the Generic view page.
  1. Just copy the part from G'views to the Object pagination page. a good solution, however I don't know if it's easy to handle. A drawback is, that the info gets stored twice.
  1. Move the part about pagination to Object Pagination and create a link from g'views to the pagination page. This appears to be the most intuitive and reasonable way.

Attachments (1)

generic_views.txt.diff (1.0 KB ) - added by Nick Efford 17 years ago.

Download all attachments as: .zip

Change History (7)

comment:1 by Michael Radziej <mir@…>, 18 years ago

Triage Stage: UnreviewedAccepted

comment:2 by Nick Efford, 17 years ago

Owner: changed from nobody to Nick Efford

comment:3 by Nick Efford, 17 years ago

I think these two pages deal with pagination from two different perspectives, and I'm not convinced that moving content from one to the other in either direction would be that helpful - so I'm going to submit a patch that simply links the two pages together.

comment:4 by Nick Efford, 17 years ago

Has patch: set

It seems the page on object pagination isn't provided as a reST document under docs, so all I've done is patched generic_views.txt.

by Nick Efford, 17 years ago

Attachment: generic_views.txt.diff added

comment:5 by Nick Efford, 17 years ago

Keywords: sprintsept14 added

comment:6 by Russell Keith-Magee, 17 years ago

Resolution: fixed
Status: newclosed

(In [6410]) Fixed #2603 -- Fixed a typo and added a helpful example reference to the generic view pagination docs. Thanks, Nick Efford.

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