Opened 8 years ago

Closed 8 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: UI/UX:

Description

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 (http://groups.google.com/group/django-users) or drop by #django on IRC (irc://irc.freenode.net/django) and we'll try to help. If you think you've found a bug, please file open a ticket at http://code.djangoproject.com/simpleticket

Attachments (1)

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

Download all attachments as: .zip

Change History (4)

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

An admonition in the introduction of tutorial01

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

  • Has patch set
  • Needs documentation unset
  • Needs tests unset
  • Owner changed from jacob to anonymous
  • Patch needs improvement unset
  • Status changed from new to assigned

Hope this does the job.

comment:2 Changed 8 years ago by mir@…

  • Owner changed from anonymous to jacob
  • Status changed from assigned to new
  • Triage Stage changed from Unreviewed to Ready for checkin

comment:3 Changed 8 years ago by jacob

  • Resolution set to fixed
  • Status changed from new to closed

(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