#16758: Documentation for TEMPLATE_CONTEXT_PROCESSORS could use additional
warning.
-------------------------------------+-------------------------------------
Reporter: cyclops | Owner:
Type: | yasar11732
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.3
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by krzysiumed):
The beginning of the warning is:
Be careful with the settings in settings.py, because settings in
settings.py override the default values. Overriding some settings may
cause ...
Word 'settings' is repeated and repeated. I suggest changing it to
something like this
Be careful when you override default values of settings, because it may
cause ...
[[br]]
Next, there is
... may cause some core or commonly used functions of Django to stop
functioning ...
I'm not sure 'functioning' is good word. I prefer simpler words, for
example:
... may cause some core or commonly used functions of Django to stop
working correctly ...
[[br]]
yasar11732, you wrote
When overriding default values, you are advised to make sure that none
of the functions of Django that you need requires previous setting to work
correctly.
Are there features of Django that cannot work correctly with non default
values of some settings? I'm asking because I'm new contributor and i
don't know everything about Django.
[[br]]
If the setting you are trying to change consists of more than one value
(e.g a tuple), ...
I suggest
If the setting you want to change is tuple, list or dictonary, ...
because there are more words 'want' than 'try' in tutorial. I'm not sure
if 'is tuple, list or directory' is more clear than 'consists of more than
one value'.
--
Ticket URL: <https://code.djangoproject.com/ticket/16758#comment:9>
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
