Tutorial 3 Needs extra funky directive

[anonymous]

At the end of:

​https://docs.djangoproject.com/en/dev/intro/tutorial03/

In the section:

Removing hardcoded URLs in templates

We are advised to remove a line from mysites_templates/polls/index.html:

<li><a href="/polls/{{ poll.id }}/">{{ poll.question }}</a></li>

and replace it with:

<li><a href="{% url 'polls.views.detail' poll.id %}">{{ poll.question }}</a></li>

With the downloaded 1.4 tgz it will only work if this directive is included:

{% load url from future %}

This isn't mentioned.

[Simon Charette]

Hi, you are using django 1.4 while reading the documentation for the development version of django.

As of django 1.5, {% load url from future %} won't be required anymore in this case, hence the omission in the development version documentation.

By the way, you can switch documentation version in the bottom right of the screen (while browsing documentation).

Thanks for reporting anyway.

[Aymeric Augustin <aymeric.augustin@…>]

In [4da1d0fd65e01abe013e0d5a9174b81c6bbfa677]:

Added a warning about the {% url %} syntax change

at the point where it bites most beginners.

Refs #18787, #18762, #18756, #18723, #18705, #18689 and several duplicates.