[Django] #36762: Added See link to FieldFetchBlocked exception documentation

[Django]

#36762: Added See link to FieldFetchBlocked exception documentation
-------------------------------------+-------------------------------------
Reporter: Mohit Sharma | Type:
| Cleanup/optimization
Status: new | Component:
| Documentation
Version: dev | Severity: Normal
Keywords: documentation | Triage Stage:
exceptions FieldFetchBlocked | Unreviewed
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
== Problem ==
The `FieldFetchBlocked` exception documentation in
`docs/ref/exceptions.txt` is missing a "See" link to related
documentation, unlike other exceptions in the same file.

== Location ==
`docs/ref/exceptions.txt`, line 173-176

== Current Documentation ==
.. exception:: FieldFetchBlocked

Raised when a field would be fetched on-demand and the
:attr:`~django.db.models.RAISE` fetch mode is active.== Solution ==
Add a "See" link to the fetch modes documentation, following the pattern
used by other exceptions like `ObjectDoesNotExist` and `ObjectNotUpdated`.

== Patch ==
I have a patch ready that adds:
See :doc:`/topics/db/fetch-modes` for more information about fetch
modes.This helps users find more detailed information about fetch modes
and when `FieldFetchBlocked` is raised.


== Solution ==
Add a "See" link to the fetch modes documentation, following the pattern
used by other exceptions like ObjectDoesNotExist and ObjectNotUpdated.
== Patch ==
I have a patch ready that adds:
See :doc:`/topics/db/fetch-modes` for more information about fetch
modes.
This helps users find more detailed information about fetch modes and when
FieldFetchBlocked is raised.
--
Ticket URL: <https://code.djangoproject.com/ticket/36762>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#36762: Added See link to FieldFetchBlocked exception documentation
-------------------------------------+-------------------------------------

Reporter: Mohit Sharma | Owner: (none)
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: dev
Severity: Normal | Resolution:

Keywords: documentation | Triage Stage:
exceptions FieldFetchBlocked | Unreviewed
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Mohit Sharma):

Pull request created: https://github.com/django/django/pull/XXXXX
--
Ticket URL: <https://code.djangoproject.com/ticket/36762#comment:1>

[Django]

#36762: Added See link to FieldFetchBlocked exception documentation
-------------------------------------+-------------------------------------
Reporter: Mohit Sharma | Owner: (none)
Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage:
exceptions FieldFetchBlocked | Unreviewed
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Mohit Sharma):

Pull request created: https://github.com/django/django/pull/20356
--
Ticket URL: <https://code.djangoproject.com/ticket/36762#comment:2>

[Django]

#36762: Added See link to FieldFetchBlocked exception documentation
-------------------------------------+-------------------------------------
Reporter: Mohit Sharma | Owner: (none)

Type: | Status: closed

Cleanup/optimization |
Component: Documentation | Version: dev

Severity: Normal | Resolution: wontfix

Keywords: documentation | Triage Stage:
exceptions FieldFetchBlocked | Unreviewed
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls):

* resolution: => wontfix
* status: new => closed

Comment:

Thanks, but I think it's okay as is -- we already link to the `RAISE`
fetch mode, which is the same document you're proposing to link to.
--
Ticket URL: <https://code.djangoproject.com/ticket/36762#comment:3>