From 67b04fdc85a3e53556df57d352a45edea2b8cee2 Mon Sep 17 00:00:00 2001
From: Wilmer Arambula <terabytesoftw@gmail.com>
Date: Mon, 19 Jan 2026 19:09:51 -0300
Subject: [PATCH 1/2] fix(tests): Update descriptions in stub classes to
 clarify purpose.

---
 CHANGELOG.md                     | 2 ++
 tests/Stub/TestBackedEnum.php    | 2 +-
 tests/Stub/TestBaseClass.php     | 2 +-
 tests/Stub/TestClass.php         | 2 +-
 tests/Stub/TestEnum.php          | 2 +-
 tests/Stub/TestIntBackedEnum.php | 2 +-
 6 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e7831d9..304a40d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,8 @@
 
 ## 0.3.1 Under development
 
+- Bug #14: Update descriptions in stub classes to clarify purpose (@terabytesoftw)
+
 ## 0.3.0 January 19, 2026
 
 - Enh #13: Refactor codebase to improve performance (@terabytesoftw)
diff --git a/tests/Stub/TestBackedEnum.php b/tests/Stub/TestBackedEnum.php
index 3041e32..ef47685 100644
--- a/tests/Stub/TestBackedEnum.php
+++ b/tests/Stub/TestBackedEnum.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Backed enum stub for tests.
+ * Stub for a backed enum.
  *
  * Provides deterministic backed values required by the test suite.
  *
diff --git a/tests/Stub/TestBaseClass.php b/tests/Stub/TestBaseClass.php
index 8606b59..99d3c4e 100644
--- a/tests/Stub/TestBaseClass.php
+++ b/tests/Stub/TestBaseClass.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Abstract base class providing a protected method and private property for testing inheritance scenarios.
+ * Stub for a abstract base class providing a protected method and private property for testing inheritance scenarios.
  *
  * Serves as a parent class in test stubs to verify property visibility and method accessibility in child classes.
  *
diff --git a/tests/Stub/TestClass.php b/tests/Stub/TestClass.php
index 95936f9..525be62 100644
--- a/tests/Stub/TestClass.php
+++ b/tests/Stub/TestClass.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Concrete test class extending TestBaseClass for inheritance and visibility testing.
+ * Stub for a concrete test class extending TestBaseClass for inheritance and visibility testing.
  *
  * Provides a private property and a protected method to verify property and method accessibility in child classes.
  *
diff --git a/tests/Stub/TestEnum.php b/tests/Stub/TestEnum.php
index 0355a19..9c0867f 100644
--- a/tests/Stub/TestEnum.php
+++ b/tests/Stub/TestEnum.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Test enum for {@see \PHPForge\Support\EnumDataProvider} dataset generation.
+ * Stub for a test enum for {@see \PHPForge\Support\EnumDataProvider} dataset generation.
  *
  * @copyright Copyright (C) 2026 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
diff --git a/tests/Stub/TestIntBackedEnum.php b/tests/Stub/TestIntBackedEnum.php
index 59669cf..226bf09 100644
--- a/tests/Stub/TestIntBackedEnum.php
+++ b/tests/Stub/TestIntBackedEnum.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Backed enum stub for tests.
+ * Stub for a nacked enum.
  *
  * Provides deterministic integer-backed values required by the test suite.
  *

From 7155737b7b46901aa1662bc8ed56a5b636fe8fba Mon Sep 17 00:00:00 2001
From: Wilmer Arambula <terabytesoftw@gmail.com>
Date: Mon, 19 Jan 2026 19:15:29 -0300
Subject: [PATCH 2/2] Apply fixed Coderabbitai review.

---
 tests/Stub/TestBaseClass.php     | 2 +-
 tests/Stub/TestIntBackedEnum.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/Stub/TestBaseClass.php b/tests/Stub/TestBaseClass.php
index 99d3c4e..9fd688f 100644
--- a/tests/Stub/TestBaseClass.php
+++ b/tests/Stub/TestBaseClass.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Stub for a abstract base class providing a protected method and private property for testing inheritance scenarios.
+ * Stub for an abstract base class providing a protected method and private property for testing inheritance scenarios.
  *
  * Serves as a parent class in test stubs to verify property visibility and method accessibility in child classes.
  *
diff --git a/tests/Stub/TestIntBackedEnum.php b/tests/Stub/TestIntBackedEnum.php
index 226bf09..7c0554a 100644
--- a/tests/Stub/TestIntBackedEnum.php
+++ b/tests/Stub/TestIntBackedEnum.php
@@ -5,7 +5,7 @@
 namespace PHPForge\Support\Tests\Stub;
 
 /**
- * Stub for a nacked enum.
+ * Stub for a backed enum.
  *
  * Provides deterministic integer-backed values required by the test suite.
  *