Opened 15 years ago

Closed 15 years ago

Last modified 15 years ago

#11959 closed (fixed)

In tutorial, admin is broken throughout most of part 3

Reported by: Carl Meyer Owned by: nobody
Component: Documentation Version: 1.1
Severity: Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

Now that the admin uses url-reversing, it can't handle a urlconf that refers to nonexistent view functions. Part 3 of the tutorial instructs users to write out four URL patterns for nonexistent views, and then slowly fills in the associated views. The last of the four is not created until midway through part 4. This means that new users who have just completed part two of the tutorial and are all excited about their new admin interface now find it mysteriously broken with ViewDoesNotExist errors throughout almost all of part 3 and the beginning of part 4, with no explanation or reference to this in the tutorial text.

The simplest solution is to write placeholder views right away for all four URL patterns. The attached patch does this (along with a couple other very minor tweaks in tutorial parts 2 and 3). The other alternative would be to instruct the user to comment out several of the patterns until their associated views are written, but this seemed to require more changes and more convoluted language.

Attachments (1)

11959_r11594.diff (2.6 KB ) - added by Carl Meyer 15 years ago.
patch to fix admin in tutorial part 3, plus two minor tweaks

Download all attachments as: .zip

Change History (3)

by Carl Meyer, 15 years ago

Attachment: 11959_r11594.diff added

patch to fix admin in tutorial part 3, plus two minor tweaks

comment:1 by Russell Keith-Magee, 15 years ago

Resolution: fixed
Status: newclosed

(In [11621]) Fixed #11959 -- Updated the tutorial to ensure that the admin site continues to work after URLpatterns are introduced. Thanks to carljm for the report and draft patch.

comment:2 by Russell Keith-Magee, 15 years ago

(In [11622]) [1.1.X] Fixed #11959 -- Updated the tutorial to ensure that the admin site continues to work after URLpatterns are introduced. Thanks to carljm for the report and draft patch.
Backport of r11621 from trunk.

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