#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.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion visit 
https://groups.google.com/d/msgid/django-updates/0107019e6fb6be6e-8e494120-4d0d-42a1-b888-65163473b565-000000%40eu-central-1.amazonses.com.

Reply via email to