Django

Code

Ticket #3354 (closed: fixed)

Opened 2 years ago

Last modified 2 years ago

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

Reported by: Simon G. <dev@simon.net.nz> Assigned to: jacob
Milestone: Component: Documentation
Version: SVN Keywords: docs
Cc: dev@simon.net.nz Triage Stage: Ready for checkin
Has patch: 1 Needs documentation: 0
Needs tests: 0 Patch needs improvement: 0

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

tutorial01.diff (1.1 kB) - added by Marc Fargas <telenieko@telenieko.com> on 01/23/07 08:14:20.
An admonition in the introduction of tutorial01

Change History

01/23/07 08:14:20 changed by Marc Fargas <telenieko@telenieko.com>

  • attachment tutorial01.diff added.

An admonition in the introduction of tutorial01

01/23/07 08:14:54 changed by Marc Fargas <telenieko@telenieko.com>

  • status changed from new to assigned.
  • needs_better_patch changed.
  • needs_tests changed.
  • owner changed from jacob to anonymous.
  • needs_docs changed.
  • has_patch set to 1.

Hope this does the job.

01/24/07 11:29:51 changed by mir@noris.de

  • owner changed from anonymous to jacob.
  • status changed from assigned to new.
  • stage changed from Unreviewed to Ready for checkin.

02/25/07 23:15:52 changed by jacob

  • status changed from new to closed.
  • resolution set to fixed.

(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.


Add/Change #3354 (Tutorial pages on website should direct users to django-users with problems)




Change Properties
Action