#12811 closed (fixed)
Tutorial 2 gets into templating details too early
Reported by: | Brad Crittenden | Owned by: | Gabriel Hurley |
---|---|---|---|
Component: | Documentation | Version: | 1.1 |
Severity: | Keywords: | ||
Cc: | Triage Stage: | Ready for checkin | |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
At the very end of lesson two there is this suggestion:
"Edit the file, and you'll see it uses a template variable called app_list. That variable contains every installed Django app. Instead of using that, you can hard-code links to object-specific admin pages in whatever way you think is best."
At this point in the tutorial there has been no discussion of the template formatting language and it is unclear how one would go about completing the suggested task if he or she wanted to limit the apps to non-admin apps, for example. The means of 'hard coding' the links has not yet been addressed. Given that I think it is silly to even have this section in the tutorial.
Attachments (1)
Change History (7)
comment:1 by , 15 years ago
milestone: | → 1.2 |
---|---|
Triage Stage: | Unreviewed → Accepted |
by , 15 years ago
Attachment: | 12811_tutorial_patch.diff added |
---|
Clarifies tutorial language and removes premature instructions on templating.
comment:2 by , 15 years ago
Has patch: | set |
---|---|
Owner: | changed from | to
Status: | new → assigned |
Summary: | Tutorial suggestion at the end of lesson 2 is inappropriate → Tutorial 2 gets into templating details too early |
Add a patch that clarifies tutorial language and removes premature instructions on templating. It's based on the verbiage given by Russell above. Thanks Russ!
comment:3 by , 15 years ago
Triage Stage: | Accepted → Ready for checkin |
---|
comment:4 by , 15 years ago
Resolution: | → fixed |
---|---|
Status: | assigned → closed |
The section is still worth having -it points out that the admin can be very heavily customized. However, it should be rephrased so that newcomers don't get bogged down in the templating details they may not understand. Something along the lines of "You'll see a reference to {% for app in app_list %} - this is Django's way of iterating over the available apps. We'll talk about the template language more in the next tutorial."