@@ -11,8 +11,6 @@ acceptable changes.
11
11
* New unit tests cover the bug fix;
12
12
* The current buggy behavior is not widely used as a "feature".
13
13
14
- While working on a bug fix, don't refactor the code or introduce new classes.
15
-
16
14
.. note ::
17
15
18
16
When documentation (or PHPDoc) is not in sync with the code, code behavior
@@ -46,7 +44,8 @@ a case by case basis:
46
44
* **Tests **: Tests that increase the code coverage can be added.
47
45
48
46
The following changes are **generally not accepted ** in a patch version, except
49
- on a case by case basis:
47
+ on a case by case basis (mostly when this is related to fixing a security
48
+ issue):
50
49
51
50
* **Performance improvement **: Performance improvement should only be accepted
52
51
if the changes are local (located in one class) and only for algorithmic
@@ -58,6 +57,16 @@ on a case by case basis:
58
57
existing code base, if they are not too invasive, and if merging them into
59
58
higher branches would not lead to complex branch merging.
60
59
60
+ * **Adding new classes or non private methods **: While working on a bug fix,
61
+ never introduce new classes or public/protected methods (or global
62
+ functions).
63
+
64
+ * **Adding configuration options **: Introducing new configuration options must
65
+ never allowed.
66
+
67
+ * **Adding new deprecations **: After a version reaches stability, new
68
+ deprecations cannot be added anymore.
69
+
61
70
Anything not explicitly listed above should be done on the next minor or major
62
71
version instead. For instance, the following changes are never accepted in a
63
72
patch version:
0 commit comments