Jacob Walls 
							
						 
					 
					
						
						
							
						
						00a84fc6f3 
					 
					
						
						
							
							Removed versionadded/changed annotations for 5.2.  
						
						
						
						
					 
					
						2025-09-17 15:17:05 -03: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 
						 
				 
			
				
					
						
							
							
								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 
							
						 
					 
					
						
						
							
						
						1ecf6889ca 
					 
					
						
						
							
							Removed double spaces after periods and within phrases.  
						
						
						
						
					 
					
						2025-07-23 10:09:43 -03:00 
						 
				 
			
				
					
						
							
							
								Ahmed Nassar 
							
						 
					 
					
						
						
							
						
						be402891cd 
					 
					
						
						
							
							Fixed   #36311  -- Unified spelling of "hardcode" and its variants in docs.  
						
						... 
						
						
						
						Co-authored-by: Natalia <124304+nessita@users.noreply.github.com > 
						
						
					 
					
						2025-04-15 14:48:55 -03:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						ab148c02ce 
					 
					
						
						
							
							Fixed   #33579  -- Specialized exception raised on forced update failures.  
						
						... 
						
						
						
						Raising DatabaseError directly made it harder than it should to
differentiate between IntegrityError when a forced update resulted in no
affected rows.
Introducing a specialized exception allows for callers to more easily
silence, log, or turn them update failures into user facing exceptions
(e.g. 404s).
Thanks Mariusz for the review. 
						
						
					 
					
						2025-03-10 21:09:15 +01:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						d5fec03dad 
					 
					
						
						
							
							Refs  #35060  -- Removed passing positional arguments to Model.save()/asave() per deprecation timeline.  
						
						
						
						
					 
					
						2025-01-15 22:28:37 +01:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						810edfd742 
					 
					
						
						
							
							Removed versionadded/changed annotations for 5.1.  
						
						... 
						
						
						
						This also removes remaining versionadded/changed annotations for older
versions. 
						
						
					 
					
						2025-01-15 22:28:37 +01:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						f054045973 
					 
					
						
						
							
							Refs  #36070  -- Referred to pk as an attribute when a composite primary key is defined.  
						
						... 
						
						
						
						This is to avoid confusion that a field is often associated with having
a single associated database column. 
						
						
					 
					
						2025-01-15 13:44:23 +01:00 
						 
				 
			
				
					
						
							
							
								Jacob Walls 
							
						 
					 
					
						
						
							
						
						d66137b39b 
					 
					
						
						
							
							Fixed   #36077  -- Corrected docs on pk value where Model.save() executes an UPDATE.  
						
						... 
						
						
						
						The empty string is no longer special-cased since
c2ba59fc1d 
						
						
					 
					
						2025-01-13 11:18:02 +01:00 
						 
				 
			
				
					
						
							
							
								Csirmaz Bendegúz 
							
						 
					 
					
						
						
							
						
						5865ff5adc 
					 
					
						
						
							
							Refs  #373  -- Added Model._is_pk_set() abstraction to check if a Model's PK is set.  
						
						
						
						
					 
					
						2024-09-09 17:46:50 -03:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						0f694ce2eb 
					 
					
						
						
							
							Made cosmetic edits to code snippets reformatted with blacken-docs.  
						
						
						
						
					 
					
						2024-05-30 09:42:05 -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 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						9c17010358 
					 
					
						
						
							
							Refs  #34059 , Refs  #34060  -- Removed outdated warning about validation of JSONField constraints.  
						
						... 
						
						
						
						Known issues have been fixed in:
- 0d8fbe2adec991602ce526aae56144 
						
						
					 
					
						2024-03-18 16:11:38 +01:00 
						 
				 
			
				
					
						
							
							
								Aivars Kalvans 
							
						 
					 
					
						
						
							
						
						f92641a636 
					 
					
						
						
							
							Fixed   #28344  -- Allowed customizing queryset in Model.refresh_from_db()/arefresh_from_db().  
						
						... 
						
						
						
						The from_queryset parameter can be used to:
- use a custom Manager
- lock the row until the end of transaction
- select additional related objects 
						
						
					 
					
						2024-01-15 10:55:14 +01:00 
						 
				 
			
				
					
						
							
							
								Salvo Polizzi 
							
						 
					 
					
						
						
							
						
						3915d4c70d 
					 
					
						
						
							
							Fixed   #35060  -- Deprecated passing positional arguments to Model.save()/asave().  
						
						
						
						
					 
					
						2024-01-02 08:42:33 +01:00 
						 
				 
			
				
					
						
							
							
								David Sanders 
							
						 
					 
					
						
						
							
						
						e47298aec4 
					 
					
						
						
							
							Refs  #31435  -- Doc'd potential infinite recursion when accessing model fields in __init__.  
						
						
						
						
					 
					
						2023-10-05 14:19:43 -03: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 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						500e01073a 
					 
					
						
						
							
							Fixed   #31262  -- Added support for mappings on model fields and ChoiceField's choices.  
						
						
						
						
					 
					
						2023-08-30 22:57:40 -03:00 
						 
				 
			
				
					
						
							
							
								Akash Kumar Sen 
							
						 
					 
					
						
						
							
						
						a40b0103bc 
					 
					
						
						
							
							Fixed   #30382  -- Allowed specifying parent classes in force_insert of Model.save().  
						
						
						
						
					 
					
						2023-06-29 21:52:52 +02:00 
						 
				 
			
				
					
						
							
							
								Ian Foote 
							
						 
					 
					
						
						
							
						
						7414704e88 
					 
					
						
						
							
							Fixed   #470  -- Added support for database defaults on fields.  
						
						... 
						
						
						
						Special thanks to Hannes Ljungberg for finding multiple implementation
gaps.
Thanks also to Simon Charette, Adam Johnson, and Mariusz Felisiak for
reviews. 
						
						
					 
					
						2023-05-12 19:11:40 +02:00 
						 
				 
			
				
					
						
							
							
								django-bot 
							
						 
					 
					
						
						
							
						
						14459f80ee 
					 
					
						
						
							
							Fixed   #34140  -- Reformatted code blocks in docs with blacken-docs.  
						
						
						
						
					 
					
						2023-03-01 13:03:56 +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 
						 
				 
			
				
					
						
							
							
								noFFENSE 
							
						 
					 
					
						
						
							
						
						5cd1385356 
					 
					
						
						
							
							Fixed   #34242  -- Doc'd that primary key is set to None when deleting objects.  
						
						
						
						
					 
					
						2023-01-20 09:36:36 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						490cccbe7e 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.1.  
						
						
						
						
					 
					
						2023-01-17 11:49:15 +01:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						9bd174b9a7 
					 
					
						
						
							
							Updated documentation and comments for RFC updates.  
						
						... 
						
						
						
						- Updated references to RFC 1123 to RFC 5322
  - Only partial as RFC 5322 sort of sub-references RFC 1123.
- Updated references to RFC 2388 to RFC 7578
  - Except RFC 2388 Section 5.3 which has no equivalent.
- Updated references to RFC 2396 to RFC 3986
- Updated references to RFC 2616 to RFC 9110
- Updated references to RFC 3066 to RFC 5646
- Updated references to RFC 7230 to RFC 9112
- Updated references to RFC 7231 to RFC 9110
- Updated references to RFC 7232 to RFC 9110
- Updated references to RFC 7234 to RFC 9111
- Tidied up style of text when referring to RFC documents 
						
						
					 
					
						2022-11-10 13:52:17 +01:00 
						 
				 
			
				
					
						
							
							
								Trey Hunner 
							
						 
					 
					
						
						
							
						
						fad070b07b 
					 
					
						
						
							
							Improved readability of string interpolation in frequently used examples in docs.  
						
						
						
						
					 
					
						2022-11-10 13:18:38 +01:00 
						 
				 
			
				
					
						
							
							
								DevilsAutumn 
							
						 
					 
					
						
						
							
						
						d5bcdf858d 
					 
					
						
						
							
							Fixed   #34112  -- Added async-compatible interface to Model methods.  
						
						... 
						
						
						
						Thanks Adam Johnson for the review. 
						
						
					 
					
						2022-11-02 09:14:17 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						004f985b91 
					 
					
						
						
							
							Refs  #34059  -- Doc'd lack of support for validation of constraints with JSONFields.  
						
						... 
						
						
						
						Thanks Dan LaManna for the report. 
						
						
					 
					
						2022-10-12 11:50:13 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						5d36a8266c 
					 
					
						
						
							
							Changed note about update_fields and pre_save() to admonition.  
						
						... 
						
						
						
						Follow up to bf47c71971 
						
						
					 
					
						2022-09-28 09:26:10 +02:00 
						 
				 
			
				
					
						
							
							
								sarahboyce 
							
						 
					 
					
						
						
							
						
						bf47c71971 
					 
					
						
						
							
							Doc'd when pre_save() is called with Model.save()'s update_fields.  
						
						
						
						
					 
					
						2022-09-27 13:46:44 +02:00 
						 
				 
			
				
					
						
							
							
								Alex Morega 
							
						 
					 
					
						
						
							
						
						de6c9c7054 
					 
					
						
						
							
							Refs  #30947  -- Changed tuples to lists where appropriate.  
						
						
						
						
					 
					
						2022-08-30 09:57:17 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						90aabd730a 
					 
					
						
						
							
							Fixed   #33724  -- Doc'd exclude argument changes in model validation.  
						
						... 
						
						
						
						Thanks אורי for the report.
Follow up to 1ea7e3157d 
						
						
					 
					
						2022-05-24 10:02:53 +02:00 
						 
				 
			
				
					
						
							
							
								Joachim Jablon 
							
						 
					 
					
						
						
							
						
						ce7321932d 
					 
					
						
						
							
							Refs  #30581  -- Updated count of steps in model validation docs.  
						
						... 
						
						
						
						Follow-up to 667105877e 
						
						
					 
					
						2022-05-18 11:38:15 +02:00 
						 
				 
			
				
					
						
							
							
								Gagaro 
							
						 
					 
					
						
						
							
						
						667105877e 
					 
					
						
						
							
							Fixed   #30581  -- Added support for Meta.constraints validation.  
						
						... 
						
						
						
						Thanks Simon Charette, Keryn Knight, and Mariusz Felisiak for reviews. 
						
						
					 
					
						2022-05-10 11:22:23 +02:00 
						 
				 
			
				
					
						
							
							
								Ali Toosi 
							
						 
					 
					
						
						
							
						
						faab9e6769 
					 
					
						
						
							
							Fixed   #33680  -- Corrected example of customizing model loading in docs.  
						
						
						
						
					 
					
						2022-05-06 06:42:03 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						1024b5e74a 
					 
					
						
						
							
							Fixed 32956 -- Lowercased spelling of "web" and "web framework" where appropriate.  
						
						
						
						
					 
					
						2021-07-29 06:24:12 +02:00 
						 
				 
			
				
					
						
							
							
								abhiabhi94 
							
						 
					 
					
						
						
							
						
						f876c7d08e 
					 
					
						
						
							
							Fixed   #32957  -- Improved visibility of arguments sections in Model.save() docs.  
						
						
						
						
					 
					
						2021-07-26 07:23:01 +02:00 
						 
				 
			
				
					
						
							
							
								Girish Sontakke 
							
						 
					 
					
						
						
							
						
						27d4573d35 
					 
					
						
						
							
							Fixed   #32755  -- Corrected Model.get_absolute_url() example in docs.  
						
						
						
						
					 
					
						2021-05-18 11:30:38 +02: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 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						b5f0efa19c 
					 
					
						
						
							
							Refs  #24763  -- Moved DoesNotExist to Model class docs.  
						
						
						
						
					 
					
						2020-07-22 12:56:21 +02:00 
						 
				 
			
				
					
						
							
							
								Tim Park 
							
						 
					 
					
						
						
							
						
						697e59d5cf 
					 
					
						
						
							
							Fixed   #31502  -- Documented Model._state.db and Model._state.adding  
						
						
						
						
					 
					
						2020-07-08 10:05:47 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						4c5236ef93 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.0.  
						
						
						
						
					 
					
						2020-05-13 09:07:51 +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 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						c7b97ac3a7 
					 
					
						
						
							
							Added missing backtick in instances docs.  
						
						
						
						
					 
					
						2020-01-17 20:26:36 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						29c126bb34 
					 
					
						
						
							
							Fixed   #31124  -- Fixed setting of get_FOO_display() when overriding inherited choices.  
						
						... 
						
						
						
						Regression in 2d38eb0ab9 
						
						
					 
					
						2020-01-15 15:35:22 +01:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						9e14bc2135 
					 
					
						
						
							
							Refs  #29260  -- Doc'd Model.save() behavior change in Django 3.0.  
						
						
						
						
					 
					
						2019-12-30 07:49:10 +01:00 
						 
				 
			
				
					
						
							
							
								Baptiste Mispelon 
							
						 
					 
					
						
						
							
						
						ff1b19da67 
					 
					
						
						
							
							Fixed   #31029  -- Used more specific links to RFCs.  
						
						
						
						
					 
					
						2019-11-27 20:54:38 +01:00 
						 
				 
			
				
					
						
							
							
								Hasan Ramezani 
							
						 
					 
					
						
						
							
						
						153c7956f8 
					 
					
						
						
							
							Fixed   #24858  -- Added support for get_FOO_display() to ArrayField and RangeFields.  
						
						... 
						
						
						
						_get_FIELD_display() crashed when Field.choices was unhashable. 
						
						
					 
					
						2019-11-08 10:59:24 +01:00