[Django] #37127: Link to form templates in documentation

[Django]

#37127: Link to form templates in documentation
-------------------------------------+-------------------------------------
Reporter: Tim Schilling | Type:
| Cleanup/optimization
Status: new | Component:
| Documentation
Version: dev | Severity: Normal
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
In the forms documentation, there are several references to the forms'
templates from the perspective of needing to customize them. A next
logical step is to reproduce that file and tweak it for a developer's own
needs. We should consider adding links to the source code for these
templates to make that reproduction a bit easier. Not every developer
realizes they can search `site-packages/django` for the templates.

I'm proposing anywhere render a value like `django/forms/field.html` we
add a source link.

This would involve 53 changes across the following files (this was a crude
search and could be wrong):

- docs/ref/forms/api.txt
- docs/ref/forms/fields.txt
- docs/ref/forms/renderers.txt
- docs/ref/forms/widgets.txt
- docs/topics/forms/index.txt
- docs/topics/forms/formsets.txt
--
Ticket URL: <https://code.djangoproject.com/ticket/37127>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37127: Link to form templates in documentation

--------------------------------------+------------------------------------
Reporter: Tim Schilling | Owner: (none)

Type: Cleanup/optimization | Status: new
Component: Documentation | Version: dev

Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0

--------------------------------------+------------------------------------
Changes (by Clifford Gama):

* stage: Unreviewed => Accepted

--
Ticket URL: <https://code.djangoproject.com/ticket/37127#comment:1>

[Django]

#37127: Link to form templates in documentation

-------------------------------------+-------------------------------------
Reporter: Tim Schilling | Owner: Rickey
Type: | Shideler
Cleanup/optimization | Status: assigned

Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0

-------------------------------------+-------------------------------------
Changes (by Rickey Shideler):

* owner: (none) => Rickey Shideler
* status: new => assigned

--
Ticket URL: <https://code.djangoproject.com/ticket/37127#comment:2>

[Django]

#37127: Link to form templates in documentation
-------------------------------------+-------------------------------------
Reporter: Tim Schilling | Owner: Rickey
Type: | Shideler
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Rickey Shideler):

* has_patch: 0 => 1

Comment:

I've opened a PR for this ticket:
https://github.com/django/django/pull/21381
--
Ticket URL: <https://code.djangoproject.com/ticket/37127#comment:3>

[Django]

#37127: Link to form templates in documentation
-------------------------------------+-------------------------------------
Reporter: Tim Schilling | Owner: Rickey
Type: | Shideler
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 1

Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Tim Schilling):

* needs_better_patch: 0 => 1

--
Ticket URL: <https://code.djangoproject.com/ticket/37127#comment:4>

[Django]

#37127: Link to form templates in documentation
-------------------------------------+-------------------------------------
Reporter: Tim Schilling | Owner: Rickey
Type: | Shideler
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Tim Schilling):

* needs_better_patch: 1 => 0

--
Ticket URL: <https://code.djangoproject.com/ticket/37127#comment:5>