Generic view descriptions should give template examples

[david.reitter@…]

When reading the docs for generic views, I wonder what the templates should like like.

It does not seem like standard templates are provided (why not?), but as a minimum, the documentation should give an example of a template for each view class.

The template variables are idiosyncratic w.r.t. the view class, e.g., the ListView defines 'object_list' as a variable. So why not give this template example:

{% block content %}
<h1>Exams</h1>
    <table>
        {% for o in object_list %}
           <tr><td>{{ o }}</td><td><a href="{% url 'exam_update' o.id %}">edit</a>&nbsp;&nbsp;<a href="{% url 'exam_delete' o.id %}">del</a></td></tr>
        {% endfor %}
    </table>
{% endblock %}

Right now, I am looking for how to correctly implement the delete confirmation template.

​https://docs.djangoproject.com/en/dev/ref/class-based-views/generic-editing/#django.views.generic.edit.DeleteView

[Baptiste Mispelon]

Seeing as we're already providing an example views.py and urls.py for most views, I think it makes sense to include an example template when it makes sense.

The only example template I could find was in ​https://docs.djangoproject.com/en/1.5/topics/class-based-views/generic-display/#generic-views-of-objects.

[Baptiste Darthenay]

Pull request here: ​https://github.com/django/django/pull/1271

[Baptiste Darthenay <baptiste+github@…>]

In 81545940c68de0d1235a2fb50e61b8619f17a3e3:

Fixed #20565 -- Added template examples for GCBV.

Thanks to David Reitter for the report,
and to Marc Tamlyn and Baptiste Mispelon for the review.

[Marc Tamlyn <marc.tamlyn@…>]

In f6567578887b7cc4efb0006ac4a3a5ba7a1c2cc7:

Merge pull request #1271 from batisteo/ticket-20565

Fixed #20565 -- Added template examples for GCBV.