﻿id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
25111	Tutorial for 1.8 breaks with recommended mysql settings	JorisBenschop	nobody	"The current tutorial mentions it is optimized for python 3.2. However, on page 1 it recommends using ""django.db.backends.mysql"" to interact with mysql. This yields an error because this backend loads the MySQLdb module which does not exist for python 3.2. Considering this is page 1 of the basic tutorial such an error should not happen.

Possible solution would be change the docs to specify that django has a dependncy on mysql.connector.python, and suggest the appropriate backend. I know this connector is external, but so is MySQLdb. 

Personally i would recommend to alter the code that runs ""import MySQLdb"" to include an exception that checks if python version is > 3 and return a message asking the user to install the correct module. Asking to install MySQLdb from python3 users is confusing.

Apologies if this is a diplicate


"	Cleanup/optimization	closed	Documentation	1.8	Normal	invalid			Unreviewed	0	0	0	0	1	0
