Opened 15 years ago

Closed 15 years ago

#12181 closed (invalid)

Django WSGI setup documention makes a critical oversight with unexperienced users

Reported by: tobz Owned by: nobody
Component: Documentation Version: 1.1
Severity: Keywords: setup wsgi settings
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

I installed Django with the intent to use it to make a website, but also to learn Python. I have never touched Python before in my life before I went to install Django. When I went to set my settings file in the WSGI configuration file, I supplied 'settings.py' naturally, as after reading the documentation, it gives a value that suggests a full filename. ('filename.extension' rather than just 'filename')

Apparently, in Python, you load modules by just using the 'filename' part, not 'filename.extension' - this seems like a critical oversight when it comes to explaining setup to people unfamiliar with Python.

I can only wonder how many users have this issue when trying to setup Django and as a result give up, and totally miss out on being able to learn both Python and Django.

I urge you to mention this caveat so that users with no Python experience don't get stuck on it like I did.

Change History (3)

comment:1 by tobz, 15 years ago

Forgot to mention, this is the documentation I'm refering to: http://docs.djangoproject.com/en/dev/howto/deployment/modwsgi/

comment:2 by JohnDoe, 15 years ago

milestone: 1.2

Why aren't you just using the development server to get started ? there's not really any reason to rush deployment if you got nothing running yet.

This is also the suggestion the tutorial has (see. http://docs.djangoproject.com/en/dev/intro/tutorial01/#the-development-server).

comment:3 by Russell Keith-Magee, 15 years ago

Resolution: invalid
Status: newclosed

I'm not sure what documentation you are referring to when you say "it gives a value that suggests a full filename".

The documentation you link to gives the speifi example:

os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'

and I can't find a single reference to settings.py, or the words "full" or "filename".

Tutorial 1 [repeats this advice http://docs.djangoproject.com/en/dev/intro/tutorial01/#playing-with-the-api].

I'm marking this invalid. If you want to provide a specific suggestion of the text that needs to be modified, feel free to reopen with that specific suggestion.

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