rfc:clear-process

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
rfc:clear-process [2019/04/25 09:41] – krakjoerfc:clear-process [2019/04/25 09:42] (current) – krakjoe
Line 10: Line 10:
 This RFC seeks to clarify the process of introduction, modification, deprecation, and removal of code from PHP. It is the case that we can codify a simple set of rules based on our release process and existing accepted norms that make it easier for contributors to structure their RFC, discussions, and the resulting vote. In addition, it should reduce the number of breaks in patch versions of PHP. This RFC seeks to clarify the process of introduction, modification, deprecation, and removal of code from PHP. It is the case that we can codify a simple set of rules based on our release process and existing accepted norms that make it easier for contributors to structure their RFC, discussions, and the resulting vote. In addition, it should reduce the number of breaks in patch versions of PHP.
  
-===== Introduction =====+===== Introduction of Code =====
  
 The introduction of new code that retains ABI compatibility may occur in minor versions. Should the new code fail to maintain ABI compatibility, it may only be introduced in a major version. The introduction of new code that retains ABI compatibility may occur in minor versions. Should the new code fail to maintain ABI compatibility, it may only be introduced in a major version.
  
-===== Modification =====+===== Modification of Code =====
  
 The modification of existing code that results in no backward compatibility break, and retains ABI compatibility may occur in a patch version: This covers the vast majority of bug fixes, for which we require no RFC. The modification of existing code that results in no backward compatibility break, and retains ABI compatibility may occur in a patch version: This covers the vast majority of bug fixes, for which we require no RFC.
Line 20: Line 20:
 The modification of existing code that results in a backward or ABI compatibility break must not occur in a patch version: For this minority of bug fixes and minor enhancements, we require an RFC. The modification of existing code that results in a backward or ABI compatibility break must not occur in a patch version: For this minority of bug fixes and minor enhancements, we require an RFC.
  
-===== Deprecation =====+===== Deprecation of Code =====
  
 The deprecation of existing code must occur in minor versions. Deprecated code shall be assumed to be targeted for removal in the following major version. The deprecation of existing code must occur in minor versions. Deprecated code shall be assumed to be targeted for removal in the following major version.
Line 26: Line 26:
 Should the focus of an RFC be on deprecation, and should that RFC be accepted, no follow up removal RFC shall be necessary. Should the focus of an RFC be on deprecation, and should that RFC be accepted, no follow up removal RFC shall be necessary.
  
-===== Removal =====+===== Removal of Code =====
  
 Removal must only occur in major versions, no code shall be removed before being deprecated. Removal must only occur in major versions, no code shall be removed before being deprecated.
Line 32: Line 32:
 Should the focus of an RFC be on removal, and should that RFC be accepted, deprecation shall be carried out as described above. Should the focus of an RFC be on removal, and should that RFC be accepted, deprecation shall be carried out as described above.
  
-===== Voting =====+==== Voting ====
  
 Should this RFC be accepted, a new section in the voting RFC shall be created containing the information agreed upon here. Should this RFC be accepted, a new section in the voting RFC shall be created containing the information agreed upon here.
  
-===== External References =====+==== External References ====
  
 http://externals.io/somewhere http://externals.io/somewhere
  
rfc/clear-process.txt · Last modified: 2019/04/25 09:42 by krakjoe

Page Tools