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
11063	Suggested method of installation	Tiago Rodrigues	Jacob	"I'd like to suggest a change on the documentation which might be a source of confusion for some persons, and lead them the wrong way.

On the main installation guide (http://docs.djangoproject.com/en/dev/topics/install/#topics-install) the suggested method of installation is mod_python. However, once we click the link on ""See How to use Django with mod_python for information on how to configure mod_python once you have it installed."", we're taken to the mod_python howto (http://docs.djangoproject.com/en/dev/howto/deployment/modpython/#howto-deployment-modpython) where we can see the following:

""The mod_python module for Apache can be used to deploy Django to a production server, although it has been mostly superseded by the simpler mod_wsgi deployment option.""

And, on the mod_wsgi page (http://docs.djangoproject.com/en/dev/howto/deployment/modwsgi/#howto-deployment-modwsgi):

""Deploying Django with Apache and mod_wsgi is the recommended way to get Django into production.""

Why aren't people led to the mod_wsgi page on the first place when accessing the main installation guide ?

Also, the main installation guide, takes people to a wiki page (http://code.djangoproject.com/wiki/ServerArrangements), when there are similar guides on the main documentation (at least for mod_wsgi and mod_python, I haven't checked others)."		closed	Documentation	1.0		fixed	documentation, mod_python, mod_wsgi		Accepted	1	0	0	0	0	0