Clifford Gama 
							
						 
					 
					
						
						
							
						
						9d93e35c20 
					 
					
						
						
							
							Fixed   #17461  -- Doc'd the presumed order of foreign keys on the intermediary model of a self-referential m2m.  
						
						... 
						
						
						
						Thanks Giannis Terzopoulos and Sarah Boyce for the reviews. 
						
						
					 
					
						2025-05-02 07:56:56 +01:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						6a2c296e70 
					 
					
						
						
							
							Fixed   #36095  -- Introduced lazy references in "Models across files" section.  
						
						
						
						
					 
					
						2025-03-21 14:09:10 +01:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						ae2736ca3b 
					 
					
						
						
							
							Fixed   #36128  -- Clarified auto-generated unique constraint on m2m through models.  
						
						
						
						
					 
					
						2025-03-04 13:06:09 +01:00 
						 
				 
			
				
					
						
							
							
								Ari Pollak 
							
						 
					 
					
						
						
							
						
						ad385ae163 
					 
					
						
						
							
							Fixed   #36037  -- Fixed default primary key type in docs.  
						
						... 
						
						
						
						BigAutoField is the default type for primary keys. In models.txt, the linked
anchor shows that the default primary key is a BigAutoField, so it now defers
to that section instead of duplicating an (incorrect) type. 
						
						
					 
					
						2025-01-02 15:25:59 +01:00 
						 
				 
			
				
					
						
							
							
								Yash 
							
						 
					 
					
						
						
							
						
						35ab2e0182 
					 
					
						
						
							
							Fixed   #35731  -- Extended db_default docs.  
						
						... 
						
						
						
						This added a missing db_default reference in docs/topics/db/models.txt,
and added a reference to the DatabaseDefault object. 
						
						
					 
					
						2024-10-23 11:48:30 +02:00 
						 
				 
			
				
					
						
							
							
								Clifford Gama 
							
						 
					 
					
						
						
							
						
						38c2065154 
					 
					
						
						
							
							Refs  #35060  -- Fixed the update to update_fields in overridden save() method docs.  
						
						... 
						
						
						
						Regression in 3915d4c70d 
						
						
					 
					
						2024-09-11 13:23:36 +02:00 
						 
				 
			
				
					
						
							
							
								Mohammad Salehi 
							
						 
					 
					
						
						
							
						
						ca47884410 
					 
					
						
						
							
							Fixed   #35623  -- Documented that a field cannot be named 'check'.  
						
						
						
						
					 
					
						2024-08-12 19:58:37 +02: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 
						 
				 
			
				
					
						
							
							
								Salvo Polizzi 
							
						 
					 
					
						
						
							
						
						3915d4c70d 
					 
					
						
						
							
							Fixed   #35060  -- Deprecated passing positional arguments to Model.save()/asave().  
						
						
						
						
					 
					
						2024-01-02 08:42:33 +01:00 
						 
				 
			
				
					
						
							
							
								Zowie Beha 
							
						 
					 
					
						
						
							
						
						8fcd7b01ee 
					 
					
						
						
							
							Fixed   #35072  -- Corrected Field.choices description in models topic.  
						
						
						
						
					 
					
						2024-01-01 18:53:01 +01: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 
						 
				 
			
				
					
						
							
							
								T. Franzel 
							
						 
					 
					
						
						
							
						
						a2eaea8f22 
					 
					
						
						
							
							Fixed   #34388  -- Allowed using choice enumeration types directly on model and form fields.  
						
						
						
						
					 
					
						2023-03-21 19:44:41 +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 
						 
				 
			
				
					
						
							
							
								sarahboyce 
							
						 
					 
					
						
						
							
						
						0678d65722 
					 
					
						
						
							
							Refs  #34099  -- Doc'd that custom Model.save() should update update_fields kwarg.  
						
						
						
						
					 
					
						2022-11-14 13:43:07 +01:00 
						 
				 
			
				
					
						
							
							
								Trey Hunner 
							
						 
					 
					
						
						
							
						
						fad070b07b 
					 
					
						
						
							
							Improved readability of string interpolation in frequently used examples in docs.  
						
						
						
						
					 
					
						2022-11-10 13:18:38 +01:00 
						 
				 
			
				
					
						
							
							
								Alex Morega 
							
						 
					 
					
						
						
							
						
						de6c9c7054 
					 
					
						
						
							
							Refs  #30947  -- Changed tuples to lists where appropriate.  
						
						
						
						
					 
					
						2022-08-30 09:57:17 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						081871bc20 
					 
					
						
						
							
							Refs  #30511  -- Updated docs about auto-incrementing primary keys on PostgreSQL.  
						
						... 
						
						
						
						Follow up to 2eea361eff 
						
						
					 
					
						2022-08-26 21:42:44 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						ac90529cc5 
					 
					
						
						
							
							Fixed docs build with sphinxcontrib-spelling 7.5.0+.  
						
						... 
						
						
						
						sphinxcontrib-spelling 7.5.0+ includes captions of figures in the set
of nodes for which the text is checked. 
						
						
					 
					
						2022-05-31 11:17:01 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						97237ad3fe 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.2.  
						
						
						
						
					 
					
						2021-09-20 21:23:01 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						225d96533a 
					 
					
						
						
							
							Fixed   #30427 ,  Fixed   #16176  -- Corrected setting descriptor in Field.contribute_to_class().  
						
						... 
						
						
						
						Co-authored-by: Jarek Glowacki <jarekwg@gmail.com > 
						
						
					 
					
						2021-06-15 12:01:28 +02: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 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						284bde3fbe 
					 
					
						
						
							
							Refs  #9475  -- Linked through_default docs to related managers methods.  
						
						
						
						
					 
					
						2020-10-22 10:08:35 +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 
						 
				 
			
				
					
						
							
							
								Greg Kaleka 
							
						 
					 
					
						
						
							
						
						5d2f5dd4cc 
					 
					
						
						
							
							Doc'd Meta inheritance from abstract parents.  
						
						
						
						
					 
					
						2020-05-01 07:48:50 +02:00 
						 
				 
			
				
					
						
							
							
								Matheus Cunha Motta 
							
						 
					 
					
						
						
							
						
						0352a44dd6 
					 
					
						
						
							
							Fixed   #31303  -- Removed outdated note about symmetrical intermediate table for self-referential ManyToManyField.  
						
						... 
						
						
						
						Follow up to 87b1ad6e73 
						
						
					 
					
						2020-02-24 08:26:29 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						d202846ced 
					 
					
						
						
							
							Refs  #29998  -- Corrected auto-created OneToOneField parent_link in MTI docs.  
						
						
						
						
					 
					
						2020-01-15 15:07:07 +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 
						 
				 
			
				
					
						
							
							
								Shai Berger 
							
						 
					 
					
						
						
							
						
						72ebe85a26 
					 
					
						
						
							
							Fixed   #27910  -- Added enumeration helpers for use in Field.choices.  
						
						... 
						
						
						
						These classes can serve as a base class for user enums, supporting
translatable human-readable names, or names automatically inferred
from the enum member name.
Additional properties make it easy to access the list of names, values
and display labels.
Thanks to the following for ideas and reviews:
Carlton Gibson, Fran Hrženjak, Ian Foote, Mariusz Felisiak, Shai Berger.
Co-authored-by: Shai Berger <shai@platonix.com >
Co-authored-by: Nick Pope <nick.pope@flightdataservices.com >
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2019-09-04 14:42:49 +02:00 
						 
				 
			
				
					
						
							
							
								Meysam 
							
						 
					 
					
						
						
							
						
						833878411c 
					 
					
						
						
							
							Fixed typo in docs/topics/db/models.txt.  
						
						
						
						
					 
					
						2019-06-24 09:04:33 +02:00 
						 
				 
			
				
					
						
							
							
								Caio Ariede 
							
						 
					 
					
						
						
							
						
						5248abe9b0 
					 
					
						
						
							
							Fixed   #30505  -- Doc'd how changes in the order of Field.choices affect migrations.  
						
						
						
						
					 
					
						2019-06-04 14:11:41 +02:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						e86cc14bd3 
					 
					
						
						
							
							Changed docs to link to Python's description of iterable.  
						
						
						
						
					 
					
						2019-05-17 17:27:19 +02:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						97d3321e89 
					 
					
						
						
							
							Changed tuple choices to list in docs.  
						
						
						
						
					 
					
						2019-05-15 14:31:42 +02:00 
						 
				 
			
				
					
						
							
							
								Collin Anderson 
							
						 
					 
					
						
						
							
						
						769355c765 
					 
					
						
						
							
							Fixed   #9475  -- Allowed RelatedManager.add(), create(), etc. for m2m with a through model.  
						
						
						
						
					 
					
						2019-01-15 11:12:17 -05:00 
						 
				 
			
				
					
						
							
							
								François Freitag 
							
						 
					 
					
						
						
							
						
						9b15ff08ba 
					 
					
						
						
							
							Used auto-numbered lists in documentation.  
						
						
						
						
					 
					
						2018-11-15 13:54:28 -05:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						8c3e0eb1c1 
					 
					
						
						
							
							Normalized spelling of "lowercase" and "lowercased".  
						
						
						
						
					 
					
						2018-09-25 10:30:18 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						d483a5f0dc 
					 
					
						
						
							
							Fixed   #29756  -- Doc'd that model field names can't end with an underscore.  
						
						
						
						
					 
					
						2018-09-14 11:38:39 -04:00 
						 
				 
			
				
					
						
							
							
								Curtis Maloney 
							
						 
					 
					
						
						
							
						
						c49ea6f591 
					 
					
						
						
							
							Refs  #20910  -- Replaced snippet directive with code-block.  
						
						
						
						
					 
					
						2018-09-10 13:00:34 -04:00 
						 
				 
			
				
					
						
							
							
								ovalseven8 
							
						 
					 
					
						
						
							
						
						22bcd3a1d8 
					 
					
						
						
							
							Fixed   #29192  -- Corrected docs regarding overriding fields from abstract base classes.  
						
						
						
						
					 
					
						2018-03-13 12:45:01 -04:00 
						 
				 
			
				
					
						
							
							
								LeeHanYeong 
							
						 
					 
					
						
						
							
						
						3ffbd54566 
					 
					
						
						
							
							Removed incorrect reference to ModelChoiceField in Field.choices docs.  
						
						
						
						
					 
					
						2017-10-13 10:37:04 -04:00 
						 
				 
			
				
					
						
							
							
								Jeremy Satterfield 
							
						 
					 
					
						
						
							
						
						473ab4610e 
					 
					
						
						
							
							Fixed   #28332  -- Fixed diamond inheritence example in docs.  
						
						
						
						
					 
					
						2017-09-02 14:10:41 -04:00 
						 
				 
			
				
					
						
							
							
								Irindu Indeera 
							
						 
					 
					
						
						
							
						
						babe9e64a6 
					 
					
						
						
							
							Fixed   #28352  -- Corrected QuerySet.values_list() return type in docs examples.  
						
						
						
						
					 
					
						2017-07-11 14:15:17 -04:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						0ad7e8f71f 
					 
					
						
						
							
							Fixed   #28003  -- Doc'd what an auto-created OneToOneField parent_link looks like.  
						
						... 
						
						
						
						Thanks Simon Charette for the draft patch. 
						
						
					 
					
						2017-04-01 21:21:15 -04:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						a3af8c99d9 
					 
					
						
						
							
							Removed extra characters in docs header underlines.  
						
						
						
						
					 
					
						2017-03-20 18:30:32 -04:00 
						 
				 
			
				
					
						
							
							
								Vytis Banaitis 
							
						 
					 
					
						
						
							
						
						d1bab24e01 
					 
					
						
						
							
							Refs  #23919 ,  #27778  -- Removed obsolete mentions of unicode.  
						
						
						
						
					 
					
						2017-01-26 08:19:27 -05:00 
						 
				 
			
				
					
						
							
							
								chillaranand 
							
						 
					 
					
						
						
							
						
						dc165ec8e5 
					 
					
						
						
							
							Refs  #23919  -- Replaced super(ClassName, self) with super() in docs.  
						
						
						
						
					 
					
						2017-01-25 11:53:05 -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 
						 
				 
			
				
					
						
							
							
								Maxime Lorant 
							
						 
					 
					
						
						
							
						
						241e1e3cd7 
					 
					
						
						
							
							Removed SHOUTING in doc examples.  
						
						
						
						
					 
					
						2017-01-09 17:00:44 -05:00