[Django] #19106: Feature request: case change on visual mode with tilde
Django
-------------------------------+----------------------------------------
Reporter: cirosantilli | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: 1.4
Severity: Normal | Keywords: template, tutorial, extend
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+----------------------------------------
Hi,
I suggest you use the
- extends template
- base.html
- the conventional title, extrahead, content_title, content, etc. blocks
combo from for the polls tutorial from the start when the template
language is first used in
https://docs.djangoproject.com/en/1.4/intro/tutorial03/
since this is an absolutely fundamental design pattern.
While the "do simple now and improve later" strategy could be used (in
tutorial 5, we say: wow, lets refactor some more code!), I think the
direct approach is better here, since it is pretty obvious that this
factors out the code.
--
Ticket URL: <https://code.djangoproject.com/ticket/19106>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
-------------------------------------+-------------------------------------
Reporter: cirosantilli | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: 1.4
Severity: Normal | Resolution:
Keywords: template, tutorial, | Triage Stage:
extend | Someday/Maybe
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
Changes (by russellm):
* needs_better_patch: => 0
* needs_tests: => 0
* needs_docs: => 0
* type: Uncategorized => New feature
* stage: Unreviewed => Someday/Maybe
Comment:
I disagree - the "simple and improve later" is a much better idea.
It's easy to explain simple things. Once the basics have been grasped, you
can extend and provide more complexity. If you introduce the complexity
early, you have to say "just do this, and ignore the reasons why", which
leads to cargo-culting.
So - marking this ticket as someday/maybe, for the purposes of introducing
a new tutorial step on template blocking.
--
Ticket URL: <https://code.djangoproject.com/ticket/19106#comment:1>
Django
-------------------------------------+-------------------------------------
Type: New feature | Status: new
Component: Documentation | Version: 1.4
Severity: Normal | Resolution:
Keywords: template, tutorial, | Triage Stage:
extend | Someday/Maybe
Has patch: 0 | Needs documentation: 0
Easy pickings: 0 | UI/UX: 0
Comment (by mattseymour):
I agree completely with @russellm comment. Could the tutorials maybe
include an end of section "Something to look at next" where we could list
some simple improvements or additional features the user could attempt?
This section would purely be additional reading / features the user could
add it without conflicting with the tutorials in anyway.
--
Ticket URL: <https://code.djangoproject.com/ticket/19106#comment:2>
Django
-------------------------------------+-------------------------------------
Type: New feature | Status: new
Component: Documentation | Version: 1.4
Severity: Normal | Resolution:
Keywords: template, tutorial, | Triage Stage:
extend | Someday/Maybe
Has patch: 0 | Needs documentation: 0
Easy pickings: 0 | UI/UX: 0
Comment (by timgraham):
Also raised in #26501. My comment from there:
In general, I think it's difficult for apps to provide sufficiently
generic templates that will integrate into a site's layout. Some have
proposed some [https://django-reusable-app-
docs.readthedocs.org/en/latest/apps/templates.html common conventions]
that may work to some extent but in my opinion trying to provide reusable
templates shouldn't be a big emphasis of reusable apps.
--
Ticket URL: <https://code.djangoproject.com/ticket/19106#comment:3>
Django
-------------------------------------+-------------------------------------
事件 法轮功 包卓轩 |
Type: New feature | Status: new
Component: Documentation | Version: 1.4
Keywords: template, tutorial, | Triage Stage:
extend | Someday/Maybe
Has patch: 0 | Needs documentation: 0
Comment (by apoorvakapoorvak923-code):
Hello, I would like to work on this ticket as my first contribution.
Can this ticket be assigned to me?
--
Ticket URL: <https://code.djangoproject.com/ticket/19106#comment:4>