Django WSGI setup documention makes a critical oversight with unexperienced users
|Reported by:||tobz||Owned by:||nobody|
|Severity:||Keywords:||setup wsgi settings|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
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.