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 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						daf7d482db 
					 
					
						
						
							
							Refs  #35234  -- Deprecated CheckConstraint.check in favor of .condition.  
						
						... 
						
						
						
						Once the deprecation period ends CheckConstraint.check() can become the
documented method that performs system checks for BaseConstraint
subclasses. 
						
						
					 
					
						2024-03-01 07:15:32 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						2abf417c81 
					 
					
						
						
							
							Refs  #27236  -- Removed Meta.index_together 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 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						02376f1f53 
					 
					
						
						
							
							Added missing backticks in docs.  
						
						
						
						
					 
					
						2023-07-21 12:54:38 +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 
						 
				 
			
				
					
						
							
							
								kimsoungryoul 
							
						 
					 
					
						
						
							
						
						78f163a4fb 
					 
					
						
						
							
							Fixed   #18468  -- Added support for comments on columns and tables.  
						
						... 
						
						
						
						Thanks Jared Chung, Tom Carrick, David Smith, Nick Pope, and Mariusz
Felisiak for reviews.
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com >
Co-authored-by: Nick Pope <nick@nickpope.me.uk > 
						
						
					 
					
						2022-12-28 06:28:07 +01:00 
						 
				 
			
				
					
						
							
							
								David Wobrock 
							
						 
					 
					
						
						
							
						
						a6385b382e 
					 
					
						
						
							
							Fixed   #27236  -- Deprecated Meta.index_together in favor of Meta.indexes.  
						
						... 
						
						
						
						This also deprecates AlterIndexTogether migration operation. 
						
						
					 
					
						2022-07-12 09:04:31 +02:00 
						 
				 
			
				
					
						
							
							
								Steven Pousty 
							
						 
					 
					
						
						
							
						
						d2c135da4c 
					 
					
						
						
							
							Fixed   #31743  -- Doc't that managed=False prevents Django from managing tables modifications.  
						
						
						
						
					 
					
						2020-06-26 08:46:01 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						0ddb4ebf7b 
					 
					
						
						
							
							Refs  #14357  -- Made Meta.ordering not affect GROUP BY queries.  
						
						... 
						
						
						
						Per deprecation timeline. 
						
						
					 
					
						2019-09-10 12:01:00 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						416c584cab 
					 
					
						
						
							
							Removed versionadded/changed annotations for 2.2.  
						
						
						
						
					 
					
						2019-09-10 12:01:00 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						514efa3129 
					 
					
						
						
							
							Fixed   #30688  -- Clarified base_manager_name docs.  
						
						
						
						
					 
					
						2019-08-09 10:08:06 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						b6c4766f53 
					 
					
						
						
							
							Refs  #29548  -- Updated docs for MariaDB support.  
						
						
						
						
					 
					
						2019-05-27 19:59:49 +02:00 
						 
				 
			
				
					
						
							
							
								Luke Plant 
							
						 
					 
					
						
						
							
						
						0c916255eb 
					 
					
						
						
							
							Changed tuple Mate.unique_together/permissions to lists in docs.  
						
						
						
						
					 
					
						2019-04-24 10:06:00 +02:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						ec7e179aeb 
					 
					
						
						
							
							Removed versionadded/changed annotations for 2.1.  
						
						
						
						
					 
					
						2019-01-17 10:50:25 -05:00 
						 
				 
			
				
					
						
							
							
								Paveł Tyślacki 
							
						 
					 
					
						
						
							
						
						bdf3863bdd 
					 
					
						
						
							
							Fixed   #30063  -- Doc'd that Meta.unique_together may be deprecated in favor of Meta.constraints.  
						
						
						
						
					 
					
						2018-12-29 20:01:29 -05:00 
						 
				 
			
				
					
						
							
							
								François Freitag 
							
						 
					 
					
						
						
							
						
						9b15ff08ba 
					 
					
						
						
							
							Used auto-numbered lists in documentation.  
						
						
						
						
					 
					
						2018-11-15 13:54:28 -05:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						8eae094638 
					 
					
						
						
							
							Generalized check constraint docs for other constraints.  
						
						
						
						
					 
					
						2018-11-13 17:57:27 -05:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						9142bebff2 
					 
					
						
						
							
							Refs  #11964  -- Changed CheckConstraint() signature to use keyword-only arguments.  
						
						... 
						
						
						
						Also renamed the `constraint` argument to `check` to better represent which
part of the constraint the provided `Q` object represents. 
						
						
					 
					
						2018-10-02 10:53:04 -04:00 
						 
				 
			
				
					
						
							
							
								Ramiro Morales 
							
						 
					 
					
						
						
							
						
						1b1f64ee5a 
					 
					
						
						
							
							Refs  #14357  -- Deprecated Meta.ordering affecting GROUP BY queries.  
						
						... 
						
						
						
						Thanks Ramiro Morales for contributing to the patch. 
						
						
					 
					
						2018-09-13 12:29:48 -04:00 
						 
				 
			
				
					
						
							
							
								Ian Foote 
							
						 
					 
					
						
						
							
						
						952f05a6db 
					 
					
						
						
							
							Fixed   #11964  -- Added support for database check constraints.  
						
						
						
						
					 
					
						2018-07-10 15:32:33 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						7543ab1f8d 
					 
					
						
						
							
							Removed versionadded/changed annotations for 2.0.  
						
						
						
						
					 
					
						2018-05-17 11:00:10 -04:00 
						 
				 
			
				
					
						
							
							
								olivierdalang 
							
						 
					 
					
						
						
							
						
						825f0beda8 
					 
					
						
						
							
							Fixed   #8936  -- Added a view permission and a read-only admin.  
						
						... 
						
						
						
						Co-authored-by: Petr Dlouhy <petr.dlouhy@email.cz >
Co-authored-by: Olivier Dalang <olivier.dalang@gmail.com > 
						
						
					 
					
						2018-05-16 06:44:55 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						5446b72003 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.11.  
						
						
						
						
					 
					
						2017-09-22 12:51:18 -04:00 
						 
				 
			
				
					
						
							
							
								François Freitag 
							
						 
					 
					
						
						
							
						
						ad4a8acdb5 
					 
					
						
						
							
							Fixed   #11557  -- Added support for a list of fields in Meta.get_latest_by and QuerySet.earliest()/latest().  
						
						
						
						
					 
					
						2017-09-05 20:14:54 -04:00 
						 
				 
			
				
					
						
							
							
								Dima Kudosh 
							
						 
					 
					
						
						
							
						
						093fd479d6 
					 
					
						
						
							
							Fixed   #28335  -- Allowed query expressions in Meta.ordering.  
						
						
						
						
					 
					
						2017-09-05 19:10:20 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						d18227e341 
					 
					
						
						
							
							Fixed   #28471  -- Clarified that Meta.indexes is preferred to index_together.  
						
						
						
						
					 
					
						2017-08-08 09:20:42 -04:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						a3af8c99d9 
					 
					
						
						
							
							Removed extra characters in docs header underlines.  
						
						
						
						
					 
					
						2017-03-20 18:30:32 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						e27e4c0339 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.10.  
						
						
						
						
					 
					
						2017-01-17 20:52:05 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						bfe0d54514 
					 
					
						
						
							
							Refs  #26230  -- Removed support for model name query lookups when using Meta.default_related_name.  
						
						... 
						
						
						
						Per deprecation timeline. 
						
						
					 
					
						2017-01-17 20:52:03 -05:00 
						 
				 
			
				
					
						
							
							
								Akshesh 
							
						 
					 
					
						
						
							
						
						6a8372e6ec 
					 
					
						
						
							
							Fixed   #26808  -- Added Meta.indexes for class-based indexes.  
						
						... 
						
						
						
						* Added the index name to its deconstruction.
* Added indexes to sqlite3.schema._remake_table() so that indexes
  aren't dropped when _remake_table() is called.
Thanks timgraham & MarkusH for review and advice. 
						
						
					 
					
						2016-08-05 18:12:51 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						3aaf6cf0f3 
					 
					
						
						
							
							Fixed   #26925  -- Linked aggregation ordering topic from Meta.ordering docs.  
						
						
						
						
					 
					
						2016-07-25 06:21:39 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						ba246bd5fe 
					 
					
						
						
							
							Fixed inconsistent indentation in docs/ref/models/options.txt  
						
						
						
						
					 
					
						2016-07-15 13:42:37 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						46a38307c2 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.9.  
						
						
						
						
					 
					
						2016-05-20 11:44:29 -04:00 
						 
				 
			
				
					
						
							
							
								Loïc Bistuer 
							
						 
					 
					
						
						
							
						
						ed0ff913c6 
					 
					
						
						
							
							Fixed   #10506 ,  #13793 ,  #14891 ,  #25201  -- Introduced new APIs to specify models' default and base managers.  
						
						... 
						
						
						
						This deprecates use_for_related_fields.
Old API:
class CustomManager(models.Model):
    use_for_related_fields = True
class Model(models.Model):
    custom_manager = CustomManager()
New API:
class Model(models.Model):
    custom_manager = CustomManager()
    class Meta:
        base_manager_name = 'custom_manager'
Refs #20932 , #25897 .
Thanks Carl Meyer for the guidance throughout this work.
Thanks Tim Graham for writing the docs. 
						
						
					 
					
						2016-05-17 12:07:22 +07:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						64aba7a8ab 
					 
					
						
						
							
							Fixed   #26438  -- Fixed multiple .objects typos in the docs.  
						
						... 
						
						
						
						Thanks Pablo Oubiña for the report. 
						
						
					 
					
						2016-03-31 18:27:47 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						c0181f2c1f 
					 
					
						
						
							
							Fixed   #26310  -- Documented that a queryset ordering must be specified to ensure ordered results.  
						
						... 
						
						
						
						Thanks Simon Charette for review. 
						
						
					 
					
						2016-03-03 17:54:07 -05:00 
						 
				 
			
				
					
						
							
							
								chenesan 
							
						 
					 
					
						
						
							
						
						b84f5ab4ec 
					 
					
						
						
							
							Fixed   #26230  -- Made default_related_name affect related_query_name.  
						
						
						
						
					 
					
						2016-02-27 08:48:32 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						54848a96dd 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.8.  
						
						
						
						
					 
					
						2015-09-23 19:31:11 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						7c0850028f 
					 
					
						
						
							
							Documented a limitation of Options.required_db_features.  
						
						
						
						
					 
					
						2015-09-03 13:37:39 -04:00 
						 
				 
			
				
					
						
							
							
								Flavio Curella 
							
						 
					 
					
						
						
							
						
						c2e70f0265 
					 
					
						
						
							
							Fixed   #21127  -- Started deprecation toward requiring on_delete for ForeignKey/OneToOneField  
						
						
						
						
					 
					
						2015-07-27 18:28:13 -04:00 
						 
				 
			
				
					
						
							
							
								johannes.linke 
							
						 
					 
					
						
						
							
						
						27c839e0fc 
					 
					
						
						
							
							Fixed   #24881  -- Clarified Meta.order_with_respect_to documentation  
						
						
						
						
					 
					
						2015-06-19 07:01:54 -04:00 
						 
				 
			
				
					
						
							
							
								Luis Del Giudice 
							
						 
					 
					
						
						
							
						
						69ddc1b3da 
					 
					
						
						
							
							Fixed   #24693  -- Added label and label_lower property to Model._meta  
						
						
						
						
					 
					
						2015-05-02 16:58:18 +02:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						8097e54832 
					 
					
						
						
							
							Fixed   #23879  -- Allowed model migration skip based on feature/vendor  
						
						... 
						
						
						
						Thanks Carl Meyer for the report and review, and Tim Graham for the
review. 
						
						
					 
					
						2015-04-18 15:17:49 +02:00 
						 
				 
			
				
					
						
							
							
								Aymeric Augustin 
							
						 
					 
					
						
						
							
						
						1b8af4cfa0 
					 
					
						
						
							
							Disallowed importing concrete models without an application.  
						
						... 
						
						
						
						Removed fragile algorithm to find which application a model belongs to.
Fixed  #21680 , #21719 . Refs #21794 . 
						
						
					 
					
						2015-02-10 21:41:19 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						c79faae761 
					 
					
						
						
							
							Removed versionadded/changed notes for 1.7.  
						
						
						
						
					 
					
						2015-02-01 21:02:40 -05:00 
						 
				 
			
				
					
						
							
							
								Florian Apolloner 
							
						 
					 
					
						
						
							
						
						1ee9507eb3 
					 
					
						
						
							
							Fixed a vesionadded directive.  
						
						
						
						
					 
					
						2014-12-29 10:22:19 +01:00