Opened 12 years ago

Closed 12 years ago

#18167 closed New feature (fixed)

"Writing your first Django app, part 1" Not Noob Friendly

Reported by: anonymous Owned by: nobody
Component: Documentation Version: 1.4
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

In "Writing your first Django app, part 1" I encountered a problem with immporting the timezone utility. I eventually discovered it's because this function isn't available with the version of Django that ships with Ubuntu. Maybe you could mention this somewhere in the tutorial for us noobs out there.

Attachments (1)

18167.diff (1020 bytes ) - added by Stephen Muss 12 years ago.
Patch for documentation additions.

Download all attachments as: .zip

Change History (5)

comment:1 by Carl Meyer, 12 years ago

Triage Stage: UnreviewedAccepted
Type: UncategorizedNew feature

Agreed - we have had many bugs filed due to people unwittingly using a version of the tutorial that doesn't match the version of Django they are using. I think it's time to actually add a step at the beginning of the tutorial where we have users check their Django version and make sure it matches, and if it doesn't, direct them to the appropriate tutorial version.

comment:2 by Aymeric Augustin, 12 years ago

Indeed, that would really be a worthy addition.

by Stephen Muss, 12 years ago

Attachment: 18167.diff added

Patch for documentation additions.

comment:3 by Stephen Muss, 12 years ago

Has patch: set

comment:4 by Claude Paroz <claude@…>, 12 years ago

Resolution: fixed
Status: newclosed

In [115d522c84d85c99b2a154e29174d95380eaf0c1]:

Fixed #18167 -- Gave advice on checking Django version in the tutorial.

Thanks smuss for the initial patch.

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