litestar
litestar copied to clipboard
docs: refactor exception usage
I made quite a lot of changes:
- I replaced
:doc:
with:ref:
since it is more reliable - I replaced things like
:class:`HTTPException <.exceptions.http_exceptions.HTTPException>`
to be just
:class:`~litestar.exceptions.http_exceptions.HTTPException`
Because it the same thing
- I changed a lot of wordings to be more readable (for my taste, please, suggest better ones)
- I changed
.. :currentmodule:: litestar.exceptions.http_exceptions
in two ways: removedpy
, because it is the default role, and reset it after the table. It can be very hard to find why something does not work in the future, when you manipulate current module without reseting it properly - I moved exception in the table to be ordered by error code, it used to be:
- I moved the paragraph about handling exceptions in different layers of the app after we introduce the layers concept :)