mirror of
				https://github.com/python-pillow/Pillow.git
				synced 2025-10-31 16:07:30 +03:00 
			
		
		
		
	Moved "Versioning" into "Release Notes"
This commit is contained in:
		
							parent
							
								
									a0f8004aa6
								
							
						
					
					
						commit
						d13a3ce7bf
					
				
							
								
								
									
										28
									
								
								RELEASING.md
									
									
									
									
									
								
							
							
						
						
									
										28
									
								
								RELEASING.md
									
									
									
									
									
								
							|  | @ -1,30 +1,8 @@ | ||||||
| # Versioning |  | ||||||
| 
 |  | ||||||
| Pillow follows Semantic Versioning. From https://semver.org/: |  | ||||||
| 
 |  | ||||||
| > Given a version number MAJOR.MINOR.PATCH, increment the: |  | ||||||
| > 1. MAJOR version when you make incompatible API changes, |  | ||||||
| > 2. MINOR version when you add functionality in a backwards compatible manner, and |  | ||||||
| > 3. PATCH version when you make backwards compatible bug fixes. |  | ||||||
| 
 |  | ||||||
| Quarterly releases (referred to as "Main Release" in the checklist below) bump at |  | ||||||
| least the MINOR version, as new functionality has likely been added in the prior three |  | ||||||
| months. |  | ||||||
| 
 |  | ||||||
| A quarterly release bumps the MAJOR version when incompatible API changes are |  | ||||||
| made, such as removing deprecated APIs or dropping an EOL Python version. In practice, |  | ||||||
| these occur every 12-18 months, guided by [Python's EOL schedule](https://devguide.python.org/#status-of-python-branches), and any APIs that have |  | ||||||
| been deprecated for at least a year are removed at the same time. |  | ||||||
| 
 |  | ||||||
| PATCH versions ("Point Release" or "Embargoed Release" in the checklist below) are for |  | ||||||
| security, installation or critical bug fixes. These are less common as it is preferred |  | ||||||
| to stick to quarterly releases. |  | ||||||
| 
 |  | ||||||
| Between quarterly releases, ".dev0" is appended to the `master` branch, indicating that this is |  | ||||||
| not a formally released copy. |  | ||||||
| 
 |  | ||||||
| # Release Checklist | # Release Checklist | ||||||
| 
 | 
 | ||||||
|  | See https://pillow.readthedocs.io/en/stable/releasenotes/versioning.html for | ||||||
|  | information about how the version numbers line up with releases. | ||||||
|  | 
 | ||||||
| ## Main Release | ## Main Release | ||||||
| 
 | 
 | ||||||
| Released quarterly on January 2nd, April 1st, July 1st and October 15th. | Released quarterly on January 2nd, April 1st, July 1st and October 15th. | ||||||
|  |  | ||||||
|  | @ -3,7 +3,8 @@ Release Notes | ||||||
| 
 | 
 | ||||||
| Pillow is released quarterly on January 2nd, April 1st, July 1st and October 15th. | Pillow is released quarterly on January 2nd, April 1st, July 1st and October 15th. | ||||||
| Patch releases are created if the latest release contains severe bugs, or if security | Patch releases are created if the latest release contains severe bugs, or if security | ||||||
| fixes are put together before a scheduled release. | fixes are put together before a scheduled release. See :ref:`versioning` for more | ||||||
|  | information. | ||||||
| 
 | 
 | ||||||
| Please use the latest version of Pillow. Functionality and security fixes should not be | Please use the latest version of Pillow. Functionality and security fixes should not be | ||||||
| expected to be backported to earlier versions. | expected to be backported to earlier versions. | ||||||
|  | @ -48,3 +49,4 @@ expected to be backported to earlier versions. | ||||||
|   3.0.0 |   3.0.0 | ||||||
|   2.8.0 |   2.8.0 | ||||||
|   2.7.0 |   2.7.0 | ||||||
|  |   versioning | ||||||
|  |  | ||||||
							
								
								
									
										30
									
								
								docs/releasenotes/versioning.rst
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										30
									
								
								docs/releasenotes/versioning.rst
									
									
									
									
									
										Normal file
									
								
							|  | @ -0,0 +1,30 @@ | ||||||
|  | .. _versioning: | ||||||
|  | 
 | ||||||
|  | Versioning | ||||||
|  | ========== | ||||||
|  | 
 | ||||||
|  | Pillow follows Semantic Versioning. From https://semver.org/: | ||||||
|  | 
 | ||||||
|  |     Given a version number MAJOR.MINOR.PATCH, increment the: | ||||||
|  | 
 | ||||||
|  |     1. MAJOR version when you make incompatible API changes, | ||||||
|  |     2. MINOR version when you add functionality in a backwards compatible manner, and | ||||||
|  |     3. PATCH version when you make backwards compatible bug fixes. | ||||||
|  | 
 | ||||||
|  | Quarterly releases ("`Main Release <https://github.com/python-pillow/Pillow/blob/master/RELEASING.md#main-release>`_") | ||||||
|  | bump at least the MINOR version, as new functionality has likely been added in the | ||||||
|  | prior three months. | ||||||
|  | 
 | ||||||
|  | A quarterly release bumps the MAJOR version when incompatible API changes are | ||||||
|  | made, such as removing deprecated APIs or dropping an EOL Python version. In practice, | ||||||
|  | these occur every 12-18 months, guided by | ||||||
|  | `Python's EOL schedule <https://devguide.python.org/#status-of-python-branches>`_, and | ||||||
|  | any APIs that have been deprecated for at least a year are removed at the same time. | ||||||
|  | 
 | ||||||
|  | PATCH versions ("`Point Release <https://github.com/python-pillow/Pillow/blob/master/RELEASING.md#point-release>`_" | ||||||
|  | or "`Embargoed Release <https://github.com/python-pillow/Pillow/blob/master/RELEASING.md#embargoed-release>`_") | ||||||
|  | are for security, installation or critical bug fixes. These are less common as it is | ||||||
|  | preferred to stick to quarterly releases. | ||||||
|  | 
 | ||||||
|  | Between quarterly releases, ".dev0" is appended to the "master" branch, indicating that | ||||||
|  | this is not a formally released copy. | ||||||
		Loading…
	
		Reference in New Issue
	
	Block a user