#30643: Docs incorrectly state that time zone support is disabled by default.
-------------------------------+--------------------------------------
Reporter: terminator14 | Owner: nobody
Type: Bug | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------------------------
Changes (by terminator14):
* status: closed => new
* resolution: duplicate =>
Comment:
From the comment by Tim Graham in the duplicate ticket (#28362), I now see
the confusion.
Django has a file with default settings at django/conf/global_settings.py,
and settings.py just overwrites those.
USE_TZ just happens to be one setting that is set as False in
global_settings.py, but True in the generated settings.py.
This is unclear in the documentation, as there is no mention of
global_settings.py, or this concept. Without mention of
global_settings.py, the note in the documentation about the time zone
support being disabled by default just leads to confusion. I would suggest
that either:
- The note about the timezone support being disabled by default be
removed, as technically, timezone support for any project is enabled by
default, despite the fact that it's set to False in global_settings.py; OR
- The concept of global_settings.py be mentioned, to clarify what it means
when the documentation says that USE_TZ is "disabled by default", while
being enabled in settings.py
I've been reading through all the Topics in the past few days, and I
haven't seen any mention of global_settings.py, or the idea that
settings.py is overwriting a global file. It was very interesting when I
read Tim Graham's comment. It's possible I missed it, but if not, it might
be a good idea to mention it somewhere in the Topics.
--
Ticket URL: <https://code.djangoproject.com/ticket/30643#comment:2>
Django <https://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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/070.af00e7bc5ab02e16d46d1dafe4d7b185%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
