Add comments about BC classes

Art4 · Oct 26, 2023 · ac25355 · ac25355
1 parent 11ce078
commit ac25355
Show file tree

Hide file tree

Showing 8 changed files with 40 additions and 16 deletions.
diff --git a/tests/BC/AccessableTest.php b/tests/BC/AccessableTest.php
@@ -15,11 +15,14 @@ class AccessableTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Accessable interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForAccessableInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements Accessable {
             /**
              * Get a value by a key

diff --git a/tests/BC/ElementTest.php b/tests/BC/ElementTest.php
@@ -17,15 +17,18 @@ class ElementTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Element interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForElementInterface(): void
     {
         $data = null;
         $manager = $this->createMock(Manager::class);
         $parent = $this->createMock(Accessable::class);
 
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class ($data, $manager, $parent) implements Element {
             /**
              * Sets the manager and parent

diff --git a/tests/BC/Exception/ExceptionTest.php b/tests/BC/Exception/ExceptionTest.php
@@ -15,11 +15,14 @@ class ExceptionTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Exception interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForExceptionInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements Exception {};
 
         $this->assertInstanceOf(Exception::class, $class);

diff --git a/tests/BC/FactoryTest.php b/tests/BC/FactoryTest.php
@@ -15,11 +15,14 @@ class FactoryTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Factory interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForFactoryInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements Factory {
             /**
              * Create a new instance of a class

diff --git a/tests/BC/Input/InputTest.php b/tests/BC/Input/InputTest.php
@@ -15,11 +15,14 @@ class InputTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Input interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForInputInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements Input {
             /**
              * Get the input as simple object

diff --git a/tests/BC/Input/RequestInputTest.php b/tests/BC/Input/RequestInputTest.php
@@ -15,11 +15,14 @@ class RequestInputTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the RequestInput interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForRequestInputInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements RequestInput {};
 
         $this->assertInstanceOf(RequestInput::class, $class);

diff --git a/tests/BC/ManagerTest.php b/tests/BC/ManagerTest.php
@@ -16,11 +16,14 @@ class ManagerTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Manager interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForManagerInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements Manager {
             /**
              * Parse the input

diff --git a/tests/BC/Serializer/SerializerTest.php b/tests/BC/Serializer/SerializerTest.php
@@ -16,11 +16,14 @@ class SerializerTest extends TestCase
 {
     /**
      * This test will test a custom implementation of the Serializer interface.
-     * DO NOT CHANGE THIS!
-     * Changes are only allowed by increasing the major version number.
      */
     public function testBcForSerializerInterface(): void
     {
+        /**
+         * DO NOT CHANGE THIS CLASS!
+         *
+         * This anonymous class represents an implementation in user code
+         */
         $class = new class () implements Serializer {
             /**
              * Serialize data