Opened 10 years ago

Closed 10 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@…> 10 years ago.
docs.

Download all attachments as: .zip

Change History (6)

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

Needs documentation: set
Triage Stage: UnreviewedDesign decision needed

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

comment:2 Changed 10 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 10 years ago by Marc Fargas <telenieko@…>

Attachment: request_response.diff added

docs.

comment:3 Changed 10 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 10 years ago by Chris Beaven

Has patch: set
Needs documentation: unset
Triage Stage: Design decision neededReady 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 10 years ago by Malcolm Tredinnick

Resolution: fixed
Status: newclosed

(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