[Django] #12181: Django WSGI setup documention makes a critical oversight with unexperienced users

[noreply-71]

#12181: Django WSGI setup documention makes a critical oversight with unexperienced
users
---------------------------------+------------------------------------------
 Reporter:  tobz                 |       Owner:  nobody    
   Status:  new                  |   Milestone:  1.2      
Component:  Documentation        |     Version:  1.1      
 Keywords:  setup wsgi settings  |       Stage:  Unreviewed
Has_patch:  0                    |  
---------------------------------+------------------------------------------
 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.

--
Ticket URL: <http://code.djangoproject.com/ticket/12181>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Django updates" group.
To post to this group, send email to django-updates@...
To unsubscribe from this group, send email to django-updates+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---

[noreply-71]

#12181: Django WSGI setup documention makes a critical oversight with unexperienced
users
------------------------------------+---------------------------------------
          Reporter:  tobz           |         Owner:  nobody            
            Status:  new            |     Milestone:  1.2                
         Component:  Documentation  |       Version:  1.1                
        Resolution:                 |      Keywords:  setup wsgi settings
             Stage:  Unreviewed     |     Has_patch:  0                  
        Needs_docs:  0              |   Needs_tests:  0                  
Needs_better_patch:  0              |  
------------------------------------+---------------------------------------
Changes (by tobz):

  * needs_better_patch:  => 0
  * needs_tests:  => 0
  * needs_docs:  => 0

Comment:

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

--
Ticket URL: <http://code.djangoproject.com/ticket/12181#comment:1>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Django updates" group.
To post to this group, send email to django-updates@...
To unsubscribe from this group, send email to django-updates+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---

[noreply-71]

#12181: Django WSGI setup documention makes a critical oversight with unexperienced
users
------------------------------------+---------------------------------------
          Reporter:  tobz           |         Owner:  nobody            
            Status:  new            |     Milestone:                    
         Component:  Documentation  |       Version:  1.1                
        Resolution:                 |      Keywords:  setup wsgi settings
             Stage:  Unreviewed     |     Has_patch:  0                  
        Needs_docs:  0              |   Needs_tests:  0                  
Needs_better_patch:  0              |  
------------------------------------+---------------------------------------
Changes (by JohnDoe):

  * milestone:  1.2 =>

Comment:

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

--
Ticket URL: <http://code.djangoproject.com/ticket/12181#comment:2>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Django updates" group.
To post to this group, send email to django-updates@...
To unsubscribe from this group, send email to django-updates+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---

[noreply-71]

#12181: Django WSGI setup documention makes a critical oversight with unexperienced
users
------------------------------------+---------------------------------------
          Reporter:  tobz           |         Owner:  nobody            
            Status:  closed         |     Milestone:                    
         Component:  Documentation  |       Version:  1.1                
        Resolution:  invalid        |      Keywords:  setup wsgi settings
             Stage:  Unreviewed     |     Has_patch:  0                  
        Needs_docs:  0              |   Needs_tests:  0                  
Needs_better_patch:  0              |  
------------------------------------+---------------------------------------
Changes (by russellm):

  * status:  new => closed
  * resolution:  => invalid

Comment:

 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.

--
Ticket URL: <http://code.djangoproject.com/ticket/12181#comment:3>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "Django updates" group.
To post to this group, send email to django-updates@...
To unsubscribe from this group, send email to django-updates+unsubscribe@...
For more options, visit this group at http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---