Opened 9 years ago

Closed 8 years ago

#2906 closed defect (fixed)

Information about 404 and 500 error handlers is only in tutorial

Reported by: mir@… Owned by: jacob
Component: Documentation Version:
Severity: normal Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

Information about 404 and 500 error handlers is only in the tutorial.

I consider the tutorial something you might read in the beginning or not. Everything that is explained in the tutorial should be covered in the reference sections (and be more detailed in the reference).

Attachments (1)

request_response.diff (2.9 KB) - added by Marc Fargas <telenieko@…> 8 years ago.
docs.

Download all attachments as: .zip

Change History (6)

comment:1 Changed 8 years ago by Simon G. <dev@…>

  • Needs documentation set
  • Triage Stage changed from Unreviewed to Design decision needed

Agreed, but where's the best place for this?

comment:2 Changed 8 years ago by Marc Fargas <telenieko@…>

Maybe the first place I'd search for such thing is http://www.djangoproject.com/documentation/request_response/ atleast 400 and 500 are responses, and it's there where the responses for all those errors are described.

Changed 8 years ago by Marc Fargas <telenieko@…>

docs.

comment:3 Changed 8 years ago by Marc Fargas <telenieko@…>

I almost borrowed the contents from tutorial03.txt so maybe tutorial03.txt can have a link there saying "more info" and leave it a bit simpler.
Hope this does the job.

I leave the "Needs documentation" just in case it's not enough/addequate.

comment:4 Changed 8 years ago by SmileyChris

  • Has patch set
  • Needs documentation unset
  • Triage Stage changed from Design decision needed to Ready for checkin

Looks good to me. We'll let a submitter decide if it's adequate enough and whether to change the tutorial 03 text.

comment:5 Changed 8 years ago by mtredinnick

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

(In [4534]) Fixed #2906 -- Added documentation about HTTP error code returns and the
default 404 and 500 code error handlers. Based on a patch from Marc Fargas.

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