Opened 9 years ago

Closed 8 years ago

#2603 closed defect (fixed)

Object Pagination is documented on the wrong page.

Reported by: lucasvo@… Owned by: nickefford
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: UI/UX:

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 nickefford 8 years ago.

Download all attachments as: .zip

Change History (7)

comment:1 Changed 8 years ago by Michael Radziej <mir@…>

  • Triage Stage changed from Unreviewed to Accepted

comment:2 Changed 8 years ago by nickefford

  • Owner changed from nobody to nickefford

comment:3 Changed 8 years ago by nickefford

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 Changed 8 years ago by nickefford

  • 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.

Changed 8 years ago by nickefford

comment:5 Changed 8 years ago by nickefford

  • Keywords sprintsept14 added

comment:6 Changed 8 years ago by russellm

  • Resolution set to fixed
  • Status changed from new to closed

(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