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 Tim Graham)

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 Tim Graham, 8 years ago

Component: UncategorizedDocumentation
Description: modified (diff)
Resolution: wontfix
Status: newclosed
Summary: New userTutorial should contain complete files at each step
Type: UncategorizedCleanup/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.

Note: See TracTickets for help on using tickets.
Back to Top