Django

Code

Ticket #2603 (closed: fixed)

Opened 2 years ago

Last modified 1 year ago

Object Pagination is documented on the wrong page.

Reported by: lucasvo@vincisolutions.ch Assigned to: nickefford
Milestone: Component: Documentation
Version: Keywords: sprintsept14
Cc: Triage Stage: Accepted
Has patch: 1 Needs documentation: 0
Needs tests: 0 Patch needs improvement: 0

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.

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

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

generic_views.txt.diff (1.0 kB) - added by nickefford on 09/14/07 18:21:14.

Change History

02/21/07 15:03:07 changed by Michael Radziej <mir@noris.de>

  • stage changed from Unreviewed to Accepted.

09/14/07 16:55:22 changed by nickefford

  • owner changed from nobody to nickefford.

09/14/07 18:04:26 changed 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.

09/14/07 18:21:02 changed by nickefford

  • has_patch set to 1.

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.

09/14/07 18:21:14 changed by nickefford

  • attachment generic_views.txt.diff added.

09/14/07 20:40:50 changed by nickefford

  • keywords set to sprintsept14.

09/23/07 01:18:50 changed by russellm

  • status changed from new to closed.
  • resolution set to fixed.

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

Add/Change #2603 (Object Pagination is documented on the wrong page.)




Change Properties
Action