Add "Test Attribute" docs

Author: roxblnfk

.vitepress/config.mts

@@ -52,6 +52,7 @@ export default defineConfig({
               text: 'Writing Tests',
               link: '/docs/writing-tests',
               items: [
+                { text: 'Test Attribute', link: '/docs/test-attribute' },
                 { text: 'Inline Tests', link: '/docs/inline-tests' },
               ],
             },
@@ -102,6 +103,7 @@ export default defineConfig({
               text: 'Пишем тесты',
               link: '/ru/docs/writing-tests',
               items: [
+                { text: 'Атрибут Test', link: '/ru/docs/test-attribute' },
                 { text: 'Встроенные тесты', link: '/ru/docs/inline-tests' },
               ],
             },

docs/test-attribute.md

@@ -0,0 +1,43 @@
+# Test Attribute
+
+The `#[Test]` attribute explicitly marks a method, function, or class as a test.
+
+Can be placed on:
+
+- **Class** — all public methods become tests
+- **Method** — only that method is a test
+- **Function** — the function is a test
+
+```php
+#[Test]
+final class OrderTest
+{
+    public function createsOrder(): void { /* ... */ }
+
+    public function calculatesTotal(): void { /* ... */ }
+
+    public function appliesDiscount(): void { /* ... */ }
+}
+
+final class UserTest
+{
+    #[Test]
+    public function validatesEmail(): void { /* ... */ }
+
+    #[Test]
+    public function checksPermissions(): void { /* ... */ }
+}
+
+#[Test]
+function checks_environment(): void { /* ... */ }
+```
+
+## When to Use
+
+Use `#[Test]` when:
+
+- You want **explicit** test declaration without relying on naming patterns
+- Your method/function name doesn't follow the `test` prefix convention
+- You prefer attribute-based discovery over convention-based
+
+The attribute can be combined with [naming conventions](./naming-conventions) in the same project.

ru/docs/test-attribute.md

@@ -0,0 +1,43 @@
+# Атрибут Test
+
+Атрибут `#[Test]` явно помечает метод, функцию или класс как тест.
+
+Можно ставить на:
+
+- **Класс** — все публичные методы становятся тестами
+- **Метод** — только этот метод является тестом
+- **Функцию** — функция является тестом
+
+```php
+#[Test]
+final class OrderTest
+{
+    public function createsOrder(): void { /* ... */ }
+
+    public function calculatesTotal(): void { /* ... */ }
+
+    public function appliesDiscount(): void { /* ... */ }
+}
+
+final class UserTest
+{
+    #[Test]
+    public function validatesEmail(): void { /* ... */ }
+
+    #[Test]
+    public function checksPermissions(): void { /* ... */ }
+}
+
+#[Test]
+function checks_environment(): void { /* ... */ }
+```
+
+## Когда использовать
+
+Используйте `#[Test]`, когда:
+
+- Хотите **явно** объявлять тесты без привязки к именам
+- Имя метода/функции не следует конвенции с префиксом `test`
+- Предпочитаете обнаружение по атрибутам, а не по конвенциям
+
+Атрибут можно комбинировать с [конвенциями именования](./naming-conventions) в одном проекте.