Opened 15 years ago

Closed 15 years ago

Last modified 12 years ago

#9464 closed (fixed)

404 section of tutorial part 3 is unclear, and not complete

Reported by: Grahack Owned by: Jacob
Component: Documentation Version:
Severity: Keywords: tutorial, error pages
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

In this section about 404 of the tutorial part 3, I find this list unclear.

  • The 404 view is also called if Django doesn't find a match after checking every regular expression in the URLconf.
  • If you don't define your own 404 view -- and simply use the default, which is recommended -- you still have one obligation: To create a 404.html template in the root of your template directory. The default 404 view will use that template for all 404 errors.
  • If DEBUG is set to True (in your settings module) then your 404 view will never be used, and the traceback will be displayed instead.

I'd prefer starting with the last item. Also, when DEBUG is set to False and if you didn't create a 404.html file, you get an error 500. I think this should be explained here.

I'd suggest:

  • If DEBUG is set to True (in your settings module) then your 404 view will never be used, and the traceback will be displayed instead.
  • The 404 view is also called if Django doesn't find a match after checking every regular expression in the URLconf.
  • If you don't define your own 404 view -- and simply use the default, which is recommended -- you still have one obligation: To create a 404.html template in the root of your template directory. The default 404 view will use that template for all 404 errors.
  • If DEBUG is set to False (in your settings module) and if you didn't create a 404.html file, an Http500 is raised.

BTW I don't like this 500 feature but this is another story. I'd prefer the server to just send a 404 Not Found.

Attachments (1)

tutorial03.reorder-404-list.patch (512 bytes) - added by Grahack 15 years ago.
patch against tutoria03.txt to clear the notes about 404

Download all attachments as: .zip

Change History (6)

Changed 15 years ago by Grahack

patch against tutoria03.txt to clear the notes about 404

comment:1 Changed 15 years ago by Grahack

Has patch: set

comment:2 Changed 15 years ago by Jacob

milestone: 1.1
Triage Stage: UnreviewedAccepted

comment:3 Changed 15 years ago by Jacob

Owner: changed from nobody to Jacob
Status: newassigned

comment:4 Changed 15 years ago by Jacob

Resolution: fixed
Status: assignedclosed

(In [10371]) Fixed a whole bunch of small docs typos, errors, and ommissions.

Fixes #8358, #8396, #8724, #9043, #9128, #9247, #9267, #9267, #9375, #9409, #9414, #9416, #9446, #9454, #9464, #9503, #9518, #9533, #9657, #9658, #9683, #9733, #9771, #9835, #9836, #9837, #9897, #9906, #9912, #9945, #9986, #9992, #10055, #10084, #10091, #10145, #10245, #10257, #10309, #10358, #10359, #10424, #10426, #10508, #10531, #10551, #10635, #10637, #10656, #10658, #10690, #10699, #19528.

Thanks to all the respective authors of those tickets.

comment:18 Changed 12 years ago by Jacob

milestone: 1.1

Milestone 1.1 deleted

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