From 4acc906ad84c851319b1310197c363ac8f0cea96 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ya=C5=9Far=20Arabac=C4=B1?= Date: Thu, 29 Sep 2011 02:04:23 +0300 Subject: [PATCH] Fix ticket #16758 I added warning in upper parts of docs/ref/settings about overriding default settings. --- docs/ref/settings.txt | 9 +++++++++ 1 files changed, 9 insertions(+), 0 deletions(-) diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 8c7fe8f..0d3a999 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -12,6 +12,15 @@ Available settings Here's a full list of all available settings, in alphabetical order, and their default values. +.. warning:: + When a new django project is created, settings.py file is populated with + settings that are deemed crucial for commonly used or core parts of a + django project. Beginners are advised to override these settings with caution. + If the setting consist of more than one value (for example, INSTALLED_APPS), + it is better to add a single value to the setting, or remove a single value from + setting rather than completely overriding its default value. When removing items + from a setting, make sure you don't need those items. + .. setting:: ABSOLUTE_URL_OVERRIDES ABSOLUTE_URL_OVERRIDES -- 1.7.6.4