Opened 6 years ago

Closed 6 years ago

Last modified 3 years ago

#11063 closed (fixed)

Suggested method of installation

Reported by: trodrigues 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 timo 6 years ago.
recommend mod_wsgi

Download all attachments as: .zip

Change History (6)

Changed 6 years ago by timo

recommend mod_wsgi

comment:1 Changed 6 years ago by timo

  • Has patch set
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted

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

comment:2 Changed 6 years ago by jacob

  • Owner changed from nobody to jacob
  • Status changed from new to assigned

comment:3 Changed 6 years ago by jacob

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

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

comment:4 Changed 6 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 3 years ago by jacob

  • milestone 1.1 deleted

Milestone 1.1 deleted

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