#25732: Update "Don’t invent a programming language" section Design Philosophies
doc
--------------------------------------+--------------------
     Reporter:  nealtodd              |      Owner:  nobody
         Type:  Cleanup/optimization  |     Status:  new
    Component:  Documentation         |    Version:  master
     Severity:  Normal                |   Keywords:
 Triage Stage:  Unreviewed            |  Has patch:  0
Easy pickings:  1                     |      UI/UX:  0
--------------------------------------+--------------------
 The "Don’t invent a programming language" section in
 [https://docs.djangoproject.com/en/1.9/misc/design-philosophies/ Design
 philosophies] states:

 > The template system intentionally doesn’t allow ... Assignment to
 variables

 However, the
 [https://docs.djangoproject.com/en/1.9/releases/1.9/#templates 1.9
 release] adds support for this via the simple_tag:

 > Template tags created with the simple_tag() helper can now store results
 in a template variable by using the as argument.

 The docs need to be made consistent, at least by removing that specific
 statement. I haven't included a PR on this as it may be the case that a
 more through rewrite of this section is due. It also states that "Advanced
 logic" isn't allowed either. With the various additional features in
 Templates in the last few versions, including jinja2 support that might be
 stretching the assertion a bit far now. True, it's not advanced compared
 to what can be done in Python, but the  logic control is quite
 sophisticated.

 Maybe just removing the first line and the two bullet points is enough? If
 so, I can submit a PR.

 NB: this is referenced here:

 https://code.djangoproject.com/ticket/6378#comment:24

 (an old open ticket that looks like it can be closed as a result of the
 single_tag update).

--
Ticket URL: <https://code.djangoproject.com/ticket/25732>
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 post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/051.f35346200a1f57026e2a4aef7ff4b9b2%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to