"Http exceptions are provided in django.http" links to a page that does not list or link to HTTP exceptions

[Daniel Greenfeld]

Finding the list of HTTP exceptions via the documentation on any version of the Django documentation appears to be challenging.

References:

• ​https://docs.djangoproject.com/en/1.8/ref/exceptions/#http-exceptions (location of problematic statement)
• ​https://docs.djangoproject.com/search/?q=http+exception&release=11
• ​https://docs.djangoproject.com/search/?q=http+error&release=11

[Tim Graham]

The only documented exception seems to be UnreadablePostError. I guess we might add things like RawPostDataException and MultiPartParserError although we'd have to confirm there is a case for using them in code outside of Django itself.

The sentence "Http exceptions are provided in django.http." means that you can import the exceptions in this section from there, not that the linked page has information about them (like the rest of the sections on that page, but maybe this needs to be clarified... we could remove the links I suppose).

We are trying to ​redo the docs search using ElasticSearch if useless search results is part of your complaint.

[Tim Graham]

​PR -- feedback welcome. We can create a separate ticket about documenting those other exceptions if needed.

[Tim Graham <timograham@…>]

In 2b19b3a031e7d5b5264bc9e880d0192301289bc2:

Fixed #24359 -- Cleaned up docs/ref/exceptions.html

[Tim Graham <timograham@…>]

In 9d6f0dce139b5dc9ee019f16623e12c6579b45e3:

[1.8.x] Fixed #24359 -- Cleaned up docs/ref/exceptions.html

Backport of 2b19b3a031e7d5b5264bc9e880d0192301289bc2 from master

[Pavel Savchenko]

I have ​a use case for adding documentation on RawPostDataException . I feel it would have helped me greatly if Django had ​this docstring in the ​Http Exceptions documenation (or even a mention in the ​HttpRequest docs).

Shall I open a new ticket or can we add a patch here?

[Tim Graham]

New ticket please.