Opened 12 years ago

Closed 12 years ago

#3354 closed (fixed)

Tutorial pages on website should direct users to django-users with problems

Reported by: Simon G. <dev@…> Owned by: Jacob
Component: Documentation Version: master
Severity: Keywords: docs
Cc: dev@… Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no


I've just cleaned up #2592 and cross-referenced it with comments on the tutorials. Most of the comments on there are simple misconfigurations, or errors where the user hasn't followed the tutorial closely enough, and these should be directed to django-users/#django where they can be helped quickly, or asked to file a ticket if there's a bug.

This would also have two follow on effects:
First, it would leave a better impression on people than having 15-20 outdated and contradictory comments complaining that Django doesn't work.
Second, it would increase visibility of common issues that people have with the tutorials so they can be fixed (because these are the first encounter with Django, we need to make them as smooth as possible).

For example:

If you have any problems with this tutorial, please post a message to django-users ( or drop by #django on IRC (irc:// and we'll try to help. If you think you've found a bug, please file open a ticket at

Attachments (1)

tutorial01.diff (1.1 KB) - added by Marc Fargas <telenieko@…> 12 years ago.
An admonition in the introduction of tutorial01

Download all attachments as: .zip

Change History (4)

Changed 12 years ago by Marc Fargas <telenieko@…>

Attachment: tutorial01.diff added

An admonition in the introduction of tutorial01

comment:1 Changed 12 years ago by Marc Fargas <telenieko@…>

Has patch: set
Owner: changed from Jacob to anonymous
Status: newassigned

Hope this does the job.

comment:2 Changed 12 years ago by mir@…

Owner: changed from anonymous to Jacob
Status: assignednew
Triage Stage: UnreviewedReady for checkin

comment:3 Changed 12 years ago by Jacob

Resolution: fixed
Status: newclosed

(In [4594]) Fixed #3354: added a message to tutorial 1 about where to go for help. Thanks to Marc Fargas for the original patch, but I ended up going with a somewhat softer wording just to be double-plus-ultra-sure not to turn anyone off.

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