Mike Edmunds 
							
						 
					 
					
						
						
							
						
						f42b89f1bf 
					 
					
						
						
							
							Fixed   #36477 , Refs  #36163  -- Added @deprecate_posargs decorator to simplify deprecation of positional arguments.  
						
						... 
						
						
						
						This helper allows marking positional-or-keyword parameters as keyword-only with a deprecation period, in a consistent and correct manner. 
						
						
					 
					
						2025-07-16 08:49:03 -03:00 
						 
				 
			
				
					
						
							
							
								Lily Foote 
							
						 
					 
					
						
						
							
						
						188799e67c 
					 
					
						
						
							
							Updated guidance to propose new feature ideas in contributing docs.  
						
						... 
						
						
						
						These changes include:
* Clarification of the new feature proposal and evaluation process.
* Reodering "points to consider" into reporting bugs section, since
  these are mostly trac-specific.
* Narrowing the guide on user interface bugs and features to just bugs.
* Updating documentation for Someday/Maybe triage stage.
Co-authored-by: Tim Schilling <schilling711@gmail.com >
Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com >
Co-authored-by: Natalia <124304+nessita@users.noreply.github.com > 
						
						
					 
					
						2025-05-13 21:38:04 -03:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						86493307f9 
					 
					
						
						
							
							Fixed   #35908  -- Retired the django-developers and django-users mailing lists.  
						
						... 
						
						
						
						Co-authored-by: Chaitanya Rahalkar <chaitanyarahalkar@squareup.com > 
						
						
					 
					
						2025-02-19 12:14:27 +01:00 
						 
				 
			
				
					
						
							
							
								Maria Hynes 
							
						 
					 
					
						
						
							
						
						db5980ddd1 
					 
					
						
						
							
							Clarified instructions on how to claim a ticket.  
						
						
						
						
					 
					
						2024-11-05 16:59:34 +01:00 
						 
				 
			
				
					
						
							
							
								Maryam Yusuf 
							
						 
					 
					
						
						
							
						
						438fc42ac6 
					 
					
						
						
							
							Expanded contributor docs on getting feedback from the wider community.  
						
						
						
						
					 
					
						2024-10-16 13:23:19 +02:00 
						 
				 
			
				
					
						
							
							
								Simon Charette 
							
						 
					 
					
						
						
							
						
						57307bbc7d 
					 
					
						
						
							
							Fixed   #35666  -- Documented stacklevel usage and testing, and adjusted test suite accordingly.  
						
						... 
						
						
						
						Over the years we've had multiple instances of hit and misses when
emitting warnings: either setting the wrong stacklevel or not setting
it at all.
This work adds assertions for the existing warnings that were declaring
the correct stacklevel, but were lacking tests for it. 
						
						
					 
					
						2024-08-28 11:44:05 -03:00 
						 
				 
			
				
					
						
							
							
								Maryam Yusuf 
							
						 
					 
					
						
						
							
						
						7e00fee3bd 
					 
					
						
						
							
							Fixed   #35546  -- Emphasised accepted ticket requirement in contributing docs.  
						
						
						
						
					 
					
						2024-07-29 15:12:43 +02:00 
						 
				 
			
				
					
						
							
							
								Maryam Yusuf 
							
						 
					 
					
						
						
							
						
						9d10c7ab33 
					 
					
						
						
							
							Referenced joining the triage and review team as motivation to do PR reviews.  
						
						
						
						
					 
					
						2024-07-29 14:46:10 +02:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						2c024c9ac0 
					 
					
						
						
							
							Added contributor guidelines for performance optimizations.  
						
						
						
						
					 
					
						2024-07-25 09:25:25 +02:00 
						 
				 
			
				
					
						
							
							
								Andreu Vallbona 
							
						 
					 
					
						
						
							
						
						55a2e3136b 
					 
					
						
						
							
							Replaced usage of "patch" with more precise terms in contributing docs.  
						
						
						
						
					 
					
						2024-07-04 17:52:19 -03:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						305757aec1 
					 
					
						
						
							
							Applied Black's 2024 stable style.  
						
						... 
						
						
						
						https://github.com/psf/black/releases/tag/24.1.0  
					
						2024-01-26 12:45:07 +01:00 
						 
				 
			
				
					
						
							
							
								Mohit Singh Sinsniwal 
							
						 
					 
					
						
						
							
						
						89f10a80d7 
					 
					
						
						
							
							Fixed   #34579  -- Added Django Forum to contributing guides.  
						
						... 
						
						
						
						Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2023-05-22 20:21:18 +02:00 
						 
				 
			
				
					
						
							
							
								Sarah Boyce 
							
						 
					 
					
						
						
							
						
						1611a3af1c 
					 
					
						
						
							
							Doc'd RemovedInDjangoXXWarning comments in deprecating a feature guide.  
						
						
						
						
					 
					
						2023-04-19 08:47:27 -03:00 
						 
				 
			
				
					
						
							
							
								django-bot 
							
						 
					 
					
						
						
							
						
						14459f80ee 
					 
					
						
						
							
							Fixed   #34140  -- Reformatted code blocks in docs with blacken-docs.  
						
						
						
						
					 
					
						2023-03-01 13:03:56 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						6015bab80e 
					 
					
						
						
							
							Refs  #34140  -- Added configurations to run blacken-docs linter and adjusted docs.  
						
						... 
						
						
						
						This adds:
- GitHub actions,
- tox configuration,
- pre-commit hook, and
- makefile rules
to run blacken-docs linter.
Co-authored-by: David Smith <smithdc@gmail.com > 
						
						
					 
					
						2023-03-01 13:02:57 +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 
						 
				 
			
				
					
						
							
							
								Ramil Yanbulatov 
							
						 
					 
					
						
						
							
						
						c6290bae9d 
					 
					
						
						
							
							Fixed   #33842  -- Used :source: role for links to repo files on GitHub.  
						
						
						
						
					 
					
						2022-08-09 14:44:51 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						653daaa60c 
					 
					
						
						
							
							Refs  #31676  -- Used term "merger" instead of "committer" in docs.  
						
						... 
						
						
						
						Follow up to caa2dd08c4carlton.gibson@noumenal.es > 
						
						
					 
					
						2022-03-22 11:13:36 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						ba94488196 
					 
					
						
						
							
							Refs  #33476  -- Adjusted docs and config files for Black.  
						
						... 
						
						
						
						Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2022-02-07 20:36:04 +01:00 
						 
				 
			
				
					
						
							
							
								Markus Holtermann 
							
						 
					 
					
						
						
							
						
						d9a266d657 
					 
					
						
						
							
							Updated Git branch "master" to "main".  
						
						... 
						
						
						
						This change follows a long discussion on django-develops:
https://groups.google.com/g/django-developers/c/tctDuKUGosc/  
						
						
					 
					
						2021-03-09 08:48:32 +01:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						3bca95cca2 
					 
					
						
						
							
							Fixed   #32165  -- Added pre-commit hooks  
						
						... 
						
						
						
						* Added pre-commit hooks for isort, flake8 and eslint
* Added documentation on how to install and use the tool 
						
						
					 
					
						2020-12-23 11:14:48 +01:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						d17b380653 
					 
					
						
						
							
							Refs  #30573  -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments.  
						
						
						
						
					 
					
						2020-05-04 12:10:47 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						cc70a0343e 
					 
					
						
						
							
							Fixed term warning on Sphinx 3.0.1+.  
						
						... 
						
						
						
						"term" role became case sensitive in Sphinx 3.0.1. 
						
						
					 
					
						2020-04-14 09:32:09 +02:00 
						 
				 
			
				
					
						
							
							
								Vibhu Agarwal 
							
						 
					 
					
						
						
							
						
						6f9ecc23f6 
					 
					
						
						
							
							Fixed   #31226  -- Fixed typo in docs/internals/contributing/writing-code/submitting-patches.txt.  
						
						
						
						
					 
					
						2020-02-03 20:16:06 +01:00 
						 
				 
			
				
					
						
							
							
								André Ericson 
							
						 
					 
					
						
						
							
						
						54a7b02112 
					 
					
						
						
							
							Fixed   #30927  -- Simplified an example of test for the deprecation warning with assertWarnsMessage().  
						
						
						
						
					 
					
						2019-10-30 13:35:36 +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 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						3428be3cf9 
					 
					
						
						
							
							Updated contributing docs for some latest practices.  
						
						
						
						
					 
					
						2018-04-06 20:46:06 -04:00 
						 
				 
			
				
					
						
							
							
								Daniel Chimeno 
							
						 
					 
					
						
						
							
						
						fbb9358149 
					 
					
						
						
							
							Replaced 'python -Wall' with 'python -Wa'.  
						
						
						
						
					 
					
						2018-03-28 13:25:03 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						61225ef721 
					 
					
						
						
							
							Removed the importance of "core developers" in triaging tickets, etc.  
						
						
						
						
					 
					
						2016-12-21 20:18:13 -05:00 
						 
				 
			
				
					
						
							
							
								shaunagm 
							
						 
					 
					
						
						
							
						
						44c7e5d374 
					 
					
						
						
							
							Fixed   #26701  -- Replaced /newticket links to Trac with /.  
						
						
						
						
					 
					
						2016-06-03 08:48:12 -04:00 
						 
				 
			
				
					
						
							
							
								Elif T. Kus 
							
						 
					 
					
						
						
							
						
						bca9faae95 
					 
					
						
						
							
							Fixed   #26020  -- Normalized header stylings in docs.  
						
						
						
						
					 
					
						2016-01-22 12:12:17 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						101dbeb673 
					 
					
						
						
							
							Corrected outdated information in submitting patches guide.  
						
						
						
						
					 
					
						2015-11-16 09:59:56 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						54848a96dd 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.8.  
						
						
						
						
					 
					
						2015-09-23 19:31:11 -04:00 
						 
				 
			
				
					
						
							
							
								Trey Hunner 
							
						 
					 
					
						
						
							
						
						ec4f219ecb 
					 
					
						
						
							
							Fixed   #22463  -- Added code style guide and JavaScript linting (EditorConfig and ESLint)  
						
						
						
						
					 
					
						2015-06-27 16:36:26 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						aed437d567 
					 
					
						
						
							
							Updated release process for new release schedule.  
						
						
						
						
					 
					
						2015-06-25 11:36:17 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						2fbea621e6 
					 
					
						
						
							
							Capitalized "Python" in docs.  
						
						
						
						
					 
					
						2015-06-05 08:24:53 -04:00 
						 
				 
			
				
					
						
							
							
								Dave Hodder 
							
						 
					 
					
						
						
							
						
						08c980d752 
					 
					
						
						
							
							Updated capitalization in the word "JavaScript" for consistency  
						
						
						
						
					 
					
						2015-05-01 13:26:42 -04:00 
						 
				 
			
				
					
						
							
							
								Peter Inglesby 
							
						 
					 
					
						
						
							
						
						a8f1c70dce 
					 
					
						
						
							
							Fixed docs typo  
						
						
						
						
					 
					
						2015-02-07 18:46:04 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						7102b99653 
					 
					
						
						
							
							Added best practices for versionadded/changed annotations.  
						
						
						
						
					 
					
						2015-01-09 13:23:29 -05:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						66f9a74b45 
					 
					
						
						
							
							Added ignore_warnings decorator  
						
						... 
						
						
						
						And removed Ignore*DeprecationWarningsMixin, now obsolete.
Thanks Berker Peksag and Tim Graham for the review. 
						
						
					 
					
						2014-12-30 18:16:25 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						6571ed14b6 
					 
					
						
						
							
							Fixed   #24049  -- Removed obsolete Java notes for Mac OS.  
						
						
						
						
					 
					
						2014-12-24 18:38:07 -05:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						3131e9cef5 
					 
					
						
						
							
							Fixed   #23923  -- Promoted Django's deprecation warnings to errors in runtests.py  
						
						
						
						
					 
					
						2014-11-29 10:27:04 -05:00 
						 
				 
			
				
					
						
							
							
								Berker Peksag 
							
						 
					 
					
						
						
							
						
						303a848631 
					 
					
						
						
							
							Fixed IRC channel name in submitting-patches.txt.  
						
						... 
						
						
						
						The development channel is #django-dev. 
						
						
					 
					
						2014-10-16 16:56:37 +03:00 
						 
				 
			
				
					
						
							
							
								Petras Zdanavičius 
							
						 
					 
					
						
						
							
						
						5a311d2ccc 
					 
					
						
						
							
							Fixed   #23103  -- Added contributing tutorial link to contributing index.  
						
						
						
						
					 
					
						2014-07-26 09:50:05 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						dd6ef3197a 
					 
					
						
						
							
							Fixed   #23015  -- Fixed major/minor release terminology in docs.  
						
						
						
						
					 
					
						2014-07-13 13:37:56 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						61960dd02c 
					 
					
						
						
							
							Added a patch review checklist.  
						
						
						
						
					 
					
						2014-06-03 11:55:17 -04:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						210d0489c5 
					 
					
						
						
							
							Fixed   #21188  -- Introduced subclasses for to-be-removed-in-django-XX warnings  
						
						... 
						
						
						
						Thanks Anssi Kääriäinen for the idea and Simon Charette for the
review. 
						
						
					 
					
						2014-03-08 09:57:40 +01:00 
						 
				 
			
				
					
						
							
							
								Unai Zalakain 
							
						 
					 
					
						
						
							
						
						3895d8899d 
					 
					
						
						
							
							Fixed   #21213  -- Added docs for Django's mailing lists.  
						
						... 
						
						
						
						Added docs/internals/mailing-lists.txt documenting the use of django's
mailing lists. All references across docs changed to point to this page.
The referencing makes use of substitution because there's no way to make
a :ref: link in a non-inline fashion in Sphinx. It also makes use of
rst_epilog Sphinx conf for making this substitutions across all the
docs. 
						
						
					 
					
						2013-10-04 10:00:36 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						5be56d0e0d 
					 
					
						
						
							
							Fixed   #21024  -- Documented how to deprecate a feature.  
						
						
						
						
					 
					
						2013-09-17 13:23:32 -04:00 
						 
				 
			
				
					
						
							
							
								russkel 
							
						 
					 
					
						
						
							
						
						f80b1063e4 
					 
					
						
						
							
							Update submitting-patches.txt  
						
						... 
						
						
						
						Few quick fixes to the terminology in order to match what is used on the Django Trac at the moment. 
						
						
					 
					
						2013-06-08 14:53:27 +09:00