Opened 8 years ago

Closed 8 years ago

Last modified 5 years ago

#11063 closed (fixed)

Suggested method of installation

Reported by: Tiago Rodrigues Owned by: Jacob
Component: Documentation Version: 1.0
Severity: Keywords: documentation, mod_python, mod_wsgi
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

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

Attachments (1)

11063.diff (2.2 KB) - added by Tim Graham 8 years ago.
recommend mod_wsgi

Download all attachments as: .zip

Change History (6)

Changed 8 years ago by Tim Graham

Attachment: 11063.diff added

recommend mod_wsgi

comment:1 Changed 8 years ago by Tim Graham

Has patch: set
Triage Stage: UnreviewedAccepted

Good call, this never got refactored when the recommendation switching from mod_python to mod_wsgi.

comment:2 Changed 8 years ago by Jacob

Owner: changed from nobody to Jacob
Status: newassigned

comment:3 Changed 8 years ago by Jacob

Resolution: fixed
Status: assignedclosed

(In [10745]) Fixed #11063: updated install docs to mention mod_wsgi instead of mod_python.

comment:4 Changed 8 years ago by Jacob

(In [10747]) [1.0.X] Fixed #11063: updated install docs to mention mod_wsgi instead of mod_python. Backport of [10745] from trunk.

comment:5 Changed 5 years ago by Jacob

milestone: 1.1

Milestone 1.1 deleted

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