David Smith 
							
						 
					 
					
						
						
							
						
						f81e6e3a53 
					 
					
						
						
							
							Refs  #36485  -- Rewrapped docs to 79 columns line length.  
						
						... 
						
						
						
						Lines in the docs files were manually adjusted to conform to the
79 columns limit per line (plus newline), improving readability and
consistency across the content. 
						
						
					 
					
						2025-08-25 10:51:10 -03:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						6f8e23d1c1 
					 
					
						
						
							
							Refs  #36485  -- Removed unnecessary parentheses in :meth: and :func: roles in docs.  
						
						
						
						
					 
					
						2025-08-25 10:51:10 -03:00 
						 
				 
			
				
					
						
							
							
								Andrew Miller 
							
						 
					 
					
						
						
							
						
						aa74c4083e 
					 
					
						
						
							
							Fixed   #23790  -- Warned about renaming AppConfig.label in docs/ref/applications.txt.  
						
						
						
						
					 
					
						2024-07-01 21:52:04 -03:00 
						 
				 
			
				
					
						
							
							
								Natalia 
							
						 
					 
					
						
						
							
						
						05cce083ad 
					 
					
						
						
							
							Removed versionadded/changed annotations for 5.0.  
						
						... 
						
						
						
						This also removes remaining versionadded/changed annotations for older
versions. 
						
						
					 
					
						2024-05-22 15:44:07 -03:00 
						 
				 
			
				
					
						
							
							
								Florian Zimmermann 
							
						 
					 
					
						
						
							
						
						fbd16438f4 
					 
					
						
						
							
							Fixed   #33143  -- Raised RuntimeWarning when performing import-time queries.  
						
						
						
						
					 
					
						2023-08-21 13:44:25 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						ef00d6ef88 
					 
					
						
						
							
							Doc'd that django.setup() is called under ASGI.  
						
						
						
						
					 
					
						2023-03-01 14:32:31 +01:00 
						 
				 
			
				
					
						
							
							
								django-bot 
							
						 
					 
					
						
						
							
						
						14459f80ee 
					 
					
						
						
							
							Fixed   #34140  -- Reformatted code blocks in docs with blacken-docs.  
						
						
						
						
					 
					
						2023-03-01 13:03:56 +01:00 
						 
				 
			
				
					
						
							
							
								Joseph Victor Zammit 
							
						 
					 
					
						
						
							
						
						ba755ca131 
					 
					
						
						
							
							Refs  #34140  -- Corrected rst code-block and various formatting issues in docs.  
						
						
						
						
					 
					
						2023-02-28 12:21:37 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						534ac48297 
					 
					
						
						
							
							Refs  #34140  -- Applied rst code-block to non-Python examples.  
						
						... 
						
						
						
						Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for
reviews. 
						
						
					 
					
						2023-02-10 19:19:13 +01:00 
						 
				 
			
				
					
						
							
							
								David 
							
						 
					 
					
						
						
							
						
						ce586ed693 
					 
					
						
						
							
							Removed hyphen from pre-/re- prefixes.  
						
						... 
						
						
						
						"prepopulate", "preload", and "preprocessing" are already in the
spelling_wordlist.
This also removes hyphen from double "e" combinations with "pre" and
"re", e.g. preexisting, preempt, reestablish, or reenter.
See also:
- https://ahdictionary.com/word/search.html?q=rerun 
- https://ahdictionary.com/word/search.html?q=recreate 
- https://ahdictionary.com/word/search.html?q=predetermined 
- https://ahdictionary.com/word/search.html?q=reuse 
- https://ahdictionary.com/word/search.html?q=reopening  
						
						
					 
					
						2022-04-28 10:44:14 +02:00 
						 
				 
			
				
					
						
							
							
								David Sanders 
							
						 
					 
					
						
						
							
						
						7c56fc8e91 
					 
					
						
						
							
							Corrected AppConfig.get_models() signature in docs.  
						
						
						
						
					 
					
						2022-03-14 06:54:16 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						97237ad3fe 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.2.  
						
						
						
						
					 
					
						2021-09-20 21:23:01 +02:00 
						 
				 
			
				
					
						
							
							
								kshitijraghav 
							
						 
					 
					
						
						
							
						
						d40402cfb0 
					 
					
						
						
							
							Fixed   #32570  -- Removed unnecessary default_auto_field in app config example.  
						
						
						
						
					 
					
						2021-03-19 12:08:46 +01:00 
						 
				 
			
				
					
						
							
							
								Tom Forbes 
							
						 
					 
					
						
						
							
						
						b5e12d490a 
					 
					
						
						
							
							Fixed   #31007  -- Allowed specifying type of auto-created primary keys.  
						
						... 
						
						
						
						This also changes the default type of auto-created primary keys
for new apps and projects to BigAutoField. 
						
						
					 
					
						2020-12-15 11:25:46 +01:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						3f2821af6b 
					 
					
						
						
							
							Fixed   #31180  -- Configured applications automatically.  
						
						
						
						
					 
					
						2020-07-21 10:35:12 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						d17b380653 
					 
					
						
						
							
							Refs  #30573  -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments.  
						
						
						
						
					 
					
						2020-05-04 12:10:47 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						971a84d6af 
					 
					
						
						
							
							Clarified AppConfig.ready() docs example.  
						
						
						
						
					 
					
						2020-01-22 13:45:22 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						3930ec1bf2 
					 
					
						
						
							
							Fixed   #31062  -- Doc'd asgi.py in tutorials and project templates.  
						
						
						
						
					 
					
						2019-12-05 08:38:39 +01:00 
						 
				 
			
				
					
						
							
							
								Tobias Kunze 
							
						 
					 
					
						
						
							
						
						4a954cfd11 
					 
					
						
						
							
							Fixed   #30573  -- Rephrased documentation to avoid words that minimise the involved difficulty.  
						
						... 
						
						
						
						This patch does not remove all occurrences of the words in question.
Rather, I went through all of the occurrences of the words listed
below, and judged if they a) suggested the reader had some kind of
knowledge/experience, and b) if they added anything of value (including
tone of voice, etc). I left most of the words alone. I looked at the
following words:
- simply/simple
- easy/easier/easiest
- obvious
- just
- merely
- straightforward
- ridiculous
Thanks to Carlton Gibson for guidance on how to approach this issue, and
to Tim Bell for providing the idea. But the enormous lion's share of
thanks go to Adam Johnson for his patient and helpful review. 
						
						
					 
					
						2019-09-06 13:27:46 +02:00 
						 
				 
			
				
					
						
							
							
								Ali Mirlou 
							
						 
					 
					
						
						
							
						
						33b9b23bbb 
					 
					
						
						
							
							Fixed typo in docs/ref/applications.txt.  
						
						
						
						
					 
					
						2019-08-23 08:48:26 +02:00 
						 
				 
			
				
					
						
							
							
								François Freitag 
							
						 
					 
					
						
						
							
						
						9b15ff08ba 
					 
					
						
						
							
							Used auto-numbered lists in documentation.  
						
						
						
						
					 
					
						2018-11-15 13:54:28 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						cfff2af02b 
					 
					
						
						
							
							Fixed   #27857  -- Dropped support for Python 3.4.  
						
						
						
						
					 
					
						2017-09-25 17:11:03 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						5446b72003 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.11.  
						
						
						
						
					 
					
						2017-09-22 12:51:18 -04:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						c651331b34 
					 
					
						
						
							
							Converted usage of ugettext* functions to their gettext* aliases  
						
						... 
						
						
						
						Thanks Tim Graham for the review. 
						
						
					 
					
						2017-02-07 09:04:04 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						d170c63351 
					 
					
						
						
							
							Refs  #23919  -- Removed misc references to Python 2.  
						
						
						
						
					 
					
						2017-01-21 20:02:00 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						f6acd1d271 
					 
					
						
						
							
							Refs  #23919  -- Removed Python 2 notes in docs.  
						
						
						
						
					 
					
						2017-01-18 11:51:29 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						e27e4c0339 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.10.  
						
						
						
						
					 
					
						2017-01-17 20:52:05 -05:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						cb7bbf97a7 
					 
					
						
						
							
							Fixed   #25966  -- Made get_user_model() work at import time.  
						
						... 
						
						
						
						This makes it equivalent to: `from django.contrib.auth.models import User`.
Thanks Aymeric Augustin for the initial patch and Tim Graham for the
review. 
						
						
					 
					
						2016-11-25 14:15:49 +01:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						625cd5bcb3 
					 
					
						
						
							
							Added require_ready argument to get_model methods.  
						
						... 
						
						
						
						This allows bringing back the behavior of Django < 1.7.
Also fixed the check for the app registry being ready in
AppConfig.get_model(s), which was inconsistent with the equivalent check in
Apps.get_model(s). That part is a backwards-incompatible change. 
						
						
					 
					
						2016-10-28 19:08:57 -04:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						efcb7e1ebf 
					 
					
						
						
							
							Modified readiness check in AppConfig.get_model(s).  
						
						... 
						
						
						
						It was inconsistent with the equivalent check in Apps.get_model(s)
because I made incorrect assumptions when I wrote that code and
needlessly complicated readiness checks.
This is a backwards-incompatible change. 
						
						
					 
					
						2016-10-28 18:42:29 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						e261337eea 
					 
					
						
						
							
							Fixed docs typos in lines ending with a dash.  
						
						
						
						
					 
					
						2016-10-06 11:01:20 -04:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						5d35181de4 
					 
					
						
						
							
							Documented AppRegistryNotReady.  
						
						
						
						
					 
					
						2016-10-06 10:21:57 -04:00 
						 
				 
			
				
					
						
							
							
								Kevin Christopher Henry 
							
						 
					 
					
						
						
							
						
						ff445f4c19 
					 
					
						
						
							
							Fixed   #26616  -- Clarified model usage in AppConfig.ready().  
						
						
						
						
					 
					
						2016-08-17 10:34:51 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						6b83f61e72 
					 
					
						
						
							
							Fixed   #27050  -- Corrected django.setup()'s parameter name in docs.  
						
						
						
						
					 
					
						2016-08-11 07:01:55 -04:00 
						 
				 
			
				
					
						
							
							
								Florian Apolloner 
							
						 
					 
					
						
						
							
						
						9baf692a58 
					 
					
						
						
							
							Fixed   #26601  -- Improved middleware per DEP 0005.  
						
						... 
						
						
						
						Thanks Tim Graham for polishing the patch, updating the tests, and
writing documentation. Thanks Carl Meyer for shepherding the DEP. 
						
						
					 
					
						2016-05-17 07:22:22 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						1f8cfcf3b4 
					 
					
						
						
							
							Fixed   #26278  -- Clarified apps.ready docs.  
						
						
						
						
					 
					
						2016-02-25 08:55:10 -05:00 
						 
				 
			
				
					
						
							
							
								Blake Griffith 
							
						 
					 
					
						
						
							
						
						5fdbd9e36c 
					 
					
						
						
							
							Changed gypsy to manouche in docs and tests.  
						
						... 
						
						
						
						"Gypsy" is considered a slur by the Romani people whom it refers to.
"manouche jazz" is used in place of "gypsy jazz" and is an accepted
term for the same genre of music. 
						
						
					 
					
						2016-02-03 09:45:30 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						b07f91600d 
					 
					
						
						
							
							Fixed   #26032  -- Moved "project root directory" to a separate paragraph.  
						
						
						
						
					 
					
						2016-01-04 10:52:20 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						e051930123 
					 
					
						
						
							
							Fixed   #25748  -- Added clarification on projects vs. applications.  
						
						... 
						
						
						
						Thanks Thomas Güttler for motivating this addition. 
						
						
					 
					
						2015-12-30 17:46:53 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						6258e16335 
					 
					
						
						
							
							Refs  #24971 ,  #25356  -- Clarified how apps.py works in 1.9 release notes.  
						
						
						
						
					 
					
						2015-11-17 19:32:32 -05:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						7d81ee6efc 
					 
					
						
						
							
							Fixed   #16734  -- Set script prefix even outside of requests  
						
						... 
						
						
						
						Thanks Tim Graham for the review. 
						
						
					 
					
						2015-10-29 20:12:38 +01:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						94a36cfd8c 
					 
					
						
						
							
							Recommended against default_app_config.  
						
						... 
						
						
						
						Most likely this is a losing fight -- people seem to love this small
convention -- but at least the reasons for avoiding it will be
documented.
Refs #25356 . 
						
						
					 
					
						2015-09-22 08:31:50 +02:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						e7e8d30cae 
					 
					
						
						
							
							Refs  #25381  -- Clarified that AppConfig model methods search only the current app.  
						
						
						
						
					 
					
						2015-09-11 14:07:12 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						862de0b254 
					 
					
						
						
							
							Fixed   #25356  -- Removed default_app_config from startapp template.  
						
						... 
						
						
						
						Also discouraged its use outside the intended use case. 
						
						
					 
					
						2015-09-07 15:23:11 -04:00 
						 
				 
			
				
					
						
							
							
								Floris den Hengst 
							
						 
					 
					
						
						
							
						
						e42a720ba2 
					 
					
						
						
							
							Fixed typos and updated spelling wordlist.  
						
						
						
						
					 
					
						2015-03-07 17:59:03 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						c79faae761 
					 
					
						
						
							
							Removed versionadded/changed notes for 1.7.  
						
						
						
						
					 
					
						2015-02-01 21:02:40 -05:00 
						 
				 
			
				
					
						
							
							
								Peter Inglesby 
							
						 
					 
					
						
						
							
						
						0fde2ca036 
					 
					
						
						
							
							Fixed typo in docs/ref/applications.txt.  
						
						
						
						
					 
					
						2014-12-06 09:22:46 -05:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						a764a9ccff 
					 
					
						
						
							
							Checked more precisely whether the app registry is ready.  
						
						... 
						
						
						
						Accounted for the three stages of population: app configs, models,
ready() methods of app configs. 
						
						
					 
					
						2014-07-12 18:49:37 +02:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						9618d68b34 
					 
					
						
						
							
							Fixed   #8033  -- Explained app registry error during translation setup  
						
						... 
						
						
						
						Thanks Tim Graham and Aymeric Augustin for the review. 
						
						
					 
					
						2014-06-23 09:31:45 +02:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						b8fc167b32 
					 
					
						
						
							
							Fixed   #22688  -- Documented ready() may be called more than once  
						
						
						
						
					 
					
						2014-05-24 15:58:57 +02:00