Opened 8 years ago
Closed 8 years ago
#27983 closed Cleanup/optimization (wontfix)
Tutorial should contain complete files at each step
Reported by: | Andrew Schell | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.10 |
Severity: | Normal | Keywords: | newuser |
Cc: | Triage Stage: | Unreviewed | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description (last modified by )
In many places the site says to add code, yet many of these strings of code are duplicates of other strings.
How am I supposed to know where to put the string...
The designer of the site assumes I know a ton of code or that I know where in my code to put the new code
"Wire these new views into the polls.urls module by adding the following url() calls:
Why don't you post the whole code at each junction rather than tease me as a new user with snippets when I have no idea where to put them in my code.
I get it that this was designed by people with a lot of experience... but for those of us who don't know django, how are we supposed to learn if your code isn't following the python "explicitly labeled" mantra?
Change History (1)
comment:1 by , 8 years ago
Component: | Uncategorized → Documentation |
---|---|
Description: | modified (diff) |
Resolution: | → wontfix |
Status: | new → closed |
Summary: | New user → Tutorial should contain complete files at each step |
Type: | Uncategorized → Cleanup/optimization |
Thanks for the feedback but I'm not sure what changes to make based on your feedback. The tutorial is designed to require some thinking rather than just copy/pasting entire files at each step. If you have some specific suggestions, feel free to offer them.