Adam Johnson 
							
						 
					 
					
						
						
							
						
						f6bd90c840 
					 
					
						
						
							
							Refs  #28586  -- Edited related objects documentation.  
						
						... 
						
						
						
						This change aims to make this section clearer and ready to add a description of
fetch modes. 
						
						
					 
					
						2025-10-16 14:52:22 -04:00 
						 
				 
			
				
					
						
							
							
								SaJH 
							
						 
					 
					
						
						
							
						
						3c0c54351b 
					 
					
						
						
							
							Fixed   #36570  -- Removed unnecessary :py domain from documentation roles.  
						
						... 
						
						
						
						Signed-off-by: SaJH <wogur981208@gmail.com > 
						
						
					 
					
						2025-08-28 08:52:43 +02:00 
						 
				 
			
				
					
						
							
							
								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 
						 
				 
			
				
					
						
							
							
								Natalia 
							
						 
					 
					
						
						
							
						
						4286a23df6 
					 
					
						
						
							
							Refs  #36485  -- Removed double spaces after periods in sentences.  
						
						
						
						
					 
					
						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 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						8e2249bc79 
					 
					
						
						
							
							Corrected jsonfield fieldlookup references.  
						
						
						
						
					 
					
						2025-06-13 09:50:56 +02:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						e03e5c751c 
					 
					
						
						
							
							Fixed   #33312  -- Raised explicit exception when copying deferred model instances.  
						
						... 
						
						
						
						Previously save() would crash with an attempted forced update message, and both
save(force_insert=True) and bulk_create() would crash with DoesNotExist errors
trying to retrieve rows with an empty primary key (id IS NULL).
Implementing deferred field model instance copying might be doable in certain
cases (e.g. when all the deferred fields are db generated) but that's not
trivial to implement in a backward compatible way.
Thanks Adam Sołtysik for the report and test and Clifford for the review. 
						
						
					 
					
						2025-05-16 08:13:57 +02:00 
						 
				 
			
				
					
						
							
							
								savanto 
							
						 
					 
					
						
						
							
						
						8620a3b0c7 
					 
					
						
						
							
							Fixed   #36085  -- Added JSONField support for negative array indexing on SQLite.  
						
						
						
						
					 
					
						2025-05-14 13:21:18 +02:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						304e9f3d6a 
					 
					
						
						
							
							Fixed   #36202  -- Added examples of JSONField __contains and __contained_by lookups with nested arrays to docs.  
						
						
						
						
					 
					
						2025-03-18 21:54:10 +01:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						efe3ca09e0 
					 
					
						
						
							
							Fixed incorrect formatting for inline pluralized code references in docs.  
						
						
						
						
					 
					
						2025-03-13 15:18:35 -03:00 
						 
				 
			
				
					
						
							
							
								hesham hatem 
							
						 
					 
					
						
						
							
						
						e03440291b 
					 
					
						
						
							
							Fixed   #36249  -- Fixed typo in docs/topics/db/queries.txt.  
						
						
						
						
					 
					
						2025-03-12 18:09:04 -03:00 
						 
				 
			
				
					
						
							
							
								Natalia 
							
						 
					 
					
						
						
							
						
						fc1119e8be 
					 
					
						
						
							
							Refs  #35502  -- Clarified models.py file path in docs/topics/db/queries.txt.  
						
						
						
						
					 
					
						2024-10-09 09:12:58 -03:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						718b32c691 
					 
					
						
						
							
							Added missing pycon directives in various docs.  
						
						
						
						
					 
					
						2023-10-25 12:27:27 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						5e4c1793b7 
					 
					
						
						
							
							Refs  #33308  -- Removed support for passing encoded JSON string literals to JSONField & co.  
						
						... 
						
						
						
						Per deprecation timeline. 
						
						
					 
					
						2023-09-18 22:12:40 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						295467c04a 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.2.  
						
						... 
						
						
						
						This also removes remaining versionadded/changed annotations for older
versions. 
						
						
					 
					
						2023-09-18 22:12:40 +02:00 
						 
				 
			
				
					
						
							
							
								Akash Kumar Sen 
							
						 
					 
					
						
						
							
						
						5f2308710b 
					 
					
						
						
							
							Fixed   #30355  -- Doc'd interaction between custom managers and prefetch_related().  
						
						
						
						
					 
					
						2023-06-07 11:48:01 +02:00 
						 
				 
			
				
					
						
							
							
								Yahya Ali 
							
						 
					 
					
						
						
							
						
						263db8af46 
					 
					
						
						
							
							Fixed   #34463  -- Corrected code-block directives in docs.  
						
						... 
						
						
						
						Thanks ExTexan for the report. 
						
						
					 
					
						2023-04-06 13:08:12 +02: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 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						490cccbe7e 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.1.  
						
						
						
						
					 
					
						2023-01-17 11:49:15 +01:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						0ff46591ac 
					 
					
						
						
							
							Refs  #33308  -- Deprecated support for passing encoded JSON string literals to JSONField & co.  
						
						... 
						
						
						
						JSON should be provided as literal Python objects an not in their
encoded string literal forms. 
						
						
					 
					
						2022-12-01 19:14:00 +01:00 
						 
				 
			
				
					
						
							
							
								Allen Jonathan David 
							
						 
					 
					
						
						
							
						
						10178197d5 
					 
					
						
						
							
							Fixed   #33966  -- Added support for using KeyTextTransform from lookup.  
						
						
						
						
					 
					
						2022-09-16 05:36:57 +02:00 
						 
				 
			
				
					
						
							
							
								Iván Camilo Triviño López 
							
						 
					 
					
						
						
							
						
						411a6ec93a 
					 
					
						
						
							
							Fixed   #33958  -- Added imports to examples in "Expressions can reference transforms" section.  
						
						
						
						
					 
					
						2022-08-30 06:03:53 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						e20e5d1557 
					 
					
						
						
							
							Fixed   #33820  -- Doc'd "true"/"false"/"null" caveat for JSONField key transforms on SQLite.  
						
						... 
						
						
						
						Thanks Johnny Metz for the report.
Regression in 71ec102b01 
						
						
					 
					
						2022-07-26 20:21:27 +02:00 
						 
				 
			
				
					
						
							
							
								Simon Willison 
							
						 
					 
					
						
						
							
						
						4525d689e9 
					 
					
						
						
							
							Refs  #33646  -- Fixed link markup in queries topic doc.  
						
						
						
						
					 
					
						2022-05-18 17:39:59 +02: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 
						 
				 
			
				
					
						
							
							
								Andrew Godwin 
							
						 
					 
					
						
						
							
						
						58b27e0dbb 
					 
					
						
						
							
							Fixed   #33646  -- Added async-compatible interface to QuerySet.  
						
						... 
						
						
						
						Thanks Simon Charette for reviews.
Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es >
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2022-04-26 20:25:23 +02:00 
						 
				 
			
				
					
						
							
							
								Ryan Heard 
							
						 
					 
					
						
						
							
						
						c6b4d62fa2 
					 
					
						
						
							
							Fixed   #29865  -- Added logical XOR support for Q() and querysets.  
						
						
						
						
					 
					
						2022-03-04 12:55:37 +01:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						847f46e9bf 
					 
					
						
						
							
							Removed redundant QuerySet.all() calls in docs and tests.  
						
						... 
						
						
						
						Most QuerySet methods are mapped onto the Manager and, in general,
it isn't necessary to call .all() on the manager. 
						
						
					 
					
						2022-02-22 10:29:38 +01:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						6174814dbe 
					 
					
						
						
							
							Fixed   #27936  -- Rewrote spanning multi-valued relationships docs.  
						
						
						
						
					 
					
						2021-12-30 08:38:04 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						1283458baa 
					 
					
						
						
							
							Added default values to Entry's fields in making queries docs.  
						
						... 
						
						
						
						This makes it easier to create a data in examples. 
						
						
					 
					
						2021-12-30 08:38:04 +01:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						76ccce64cc 
					 
					
						
						
							
							Fixed   #16063  -- Adjusted admin changelist searches spanning multi-valued relationships.  
						
						... 
						
						
						
						This reduces the likelihood of admin searches issuing queries with
excessive joins. 
						
						
					 
					
						2021-12-15 08:14:19 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						97237ad3fe 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.2.  
						
						
						
						
					 
					
						2021-09-20 21:23:01 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						1024b5e74a 
					 
					
						
						
							
							Fixed 32956 -- Lowercased spelling of "web" and "web framework" where appropriate.  
						
						
						
						
					 
					
						2021-07-29 06:24:12 +02:00 
						 
				 
			
				
					
						
							
							
								Johannes Wilm 
							
						 
					 
					
						
						
							
						
						0fd05df7b5 
					 
					
						
						
							
							Refs  #4027  -- Added Model._state.adding to docs about copying model instances.  
						
						
						
						
					 
					
						2021-02-22 11:14:58 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						73ffc73b68 
					 
					
						
						
							
							Corrected versionadded annotations.  
						
						
						
						
					 
					
						2021-01-19 11:52:47 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						b7dd89ed53 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.1.  
						
						
						
						
					 
					
						2021-01-14 17:50:04 +01:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						550297d20d 
					 
					
						
						
							
							Added backticks to code literals in various docs.  
						
						
						
						
					 
					
						2020-12-15 07:19:00 +01:00 
						 
				 
			
				
					
						
							
							
								Ian Foote 
							
						 
					 
					
						
						
							
						
						8b040e3cbb 
					 
					
						
						
							
							Fixed   #25534 ,  Fixed   #31639  -- Added support for transform references in expressions.  
						
						... 
						
						
						
						Thanks Mariusz Felisiak and Simon Charette for reviews. 
						
						
					 
					
						2020-11-27 20:42:04 +01:00 
						 
				 
			
				
					
						
							
							
								Hasan Ramezani 
							
						 
					 
					
						
						
							
						
						c448e614c6 
					 
					
						
						
							
							Fixed   #32187  -- Removed unnecessary select_related in queries doc.  
						
						
						
						
					 
					
						2020-11-12 10:06:04 +01:00 
						 
				 
			
				
					
						
							
							
								jpribyl 
							
						 
					 
					
						
						
							
						
						17407eca59 
					 
					
						
						
							
							Fixed   #31894  -- Added note about using JSONField key lookups with QuerySet.exclude() in docs.  
						
						
						
						
					 
					
						2020-09-04 09:04:38 +02:00 
						 
				 
			
				
					
						
							
							
								sage 
							
						 
					 
					
						
						
							
						
						2d8dcba03a 
					 
					
						
						
							
							Fixed   #31829  -- Used JSONField __contains lookup on key transforms.  
						
						
						
						
					 
					
						2020-07-28 13:10:12 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						ba691933ce 
					 
					
						
						
							
							Fixed   #31836  -- Dropped support for JSONField __contains and __contained_by lookups on SQLite.  
						
						... 
						
						
						
						The current implementation works only for basic examples without
supporting nested structures and doesn't follow "the general principle
that the contained object must match the containing object as to
structure and data contents, possibly after discarding some
non-matching array elements or object key/value pairs from the
containing object". 
						
						
					 
					
						2020-07-28 13:06:52 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						02447fb133 
					 
					
						
						
							
							Fixed   #31835  -- Dropped support for JSONField __contains lookup on Oracle.  
						
						... 
						
						
						
						The current implementation works only for basic examples without
supporting nested structures and doesn't follow "the general principle
that the contained object must match the containing object as to
structure and data contents, possibly after discarding some
non-matching array elements or object key/value pairs from the
containing object". 
						
						
					 
					
						2020-07-28 11:54:01 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						dbdc192ca3 
					 
					
						
						
							
							Preferred usage of among/while to amongst/whilst.  
						
						
						
						
					 
					
						2020-06-03 21:02:48 +02:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						494ba27b5f 
					 
					
						
						
							
							Changed some doc links to use intersphinx.  
						
						
						
						
					 
					
						2020-05-29 21:09:57 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						5af17babb0 
					 
					
						
						
							
							Fixed   #31591  -- Clarified "reverse" lookup name in making queries docs.  
						
						
						
						
					 
					
						2020-05-19 20:27:05 +02:00 
						 
				 
			
				
					
						
							
							
								sage 
							
						 
					 
					
						
						
							
						
						6789ded0a6 
					 
					
						
						
							
							Fixed   #12990 , Refs  #27694  -- Added JSONField model field.  
						
						... 
						
						
						
						Thanks to Adam Johnson, Carlton Gibson, Mariusz Felisiak, and Raphael
Michel for mentoring this Google Summer of Code 2019 project and
everyone else who helped with the patch.
Special thanks to Mads Jensen, Nick Pope, and Simon Charette for
extensive reviews.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2020-05-08 07:23:31 +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