Add "Naming Conventions" docs

Author: roxblnfk

.vitepress/config.mts

@@ -53,6 +53,7 @@ export default defineConfig({
               link: '/docs/writing-tests',
               items: [
                 { text: 'Test Attribute', link: '/docs/test-attribute' },
+                { text: 'Naming Conventions', link: '/docs/naming-conventions' },
                 { text: 'Inline Tests', link: '/docs/inline-tests' },
               ],
             },
@@ -104,6 +105,7 @@ export default defineConfig({
               link: '/ru/docs/writing-tests',
               items: [
                 { text: 'Атрибут Test', link: '/ru/docs/test-attribute' },
+                { text: 'Конвенции именования', link: '/ru/docs/naming-conventions' },
                 { text: 'Встроенные тесты', link: '/ru/docs/inline-tests' },
               ],
             },

docs/naming-conventions.md

@@ -0,0 +1,29 @@
+# Naming Conventions
+
+Testo can discover tests by naming patterns — no attributes required.
+
+Recognized patterns:
+
+- **Class + Method** — `*Test` suffix on class and `test*` prefix on methods
+- **Function** — `test*` prefix on function
+
+```php
+final class UserServiceTest
+{
+    public function testCreatesUser(): void { /* ... */ }
+
+    public function testDeletesUser(): void { /* ... */ }
+
+    public function testUpdatesProfile(): void { /* ... */ }
+}
+
+function testEmailValidator(): void { /* ... */ }
+```
+
+## When to Use
+
+Use naming conventions when:
+
+- You prefer **implicit** test discovery without extra attributes
+- You're migrating from PHPUnit or other frameworks that use similar patterns
+- You want tests to be recognizable at a glance by their names

docs/test-attribute.md

@@ -39,5 +39,3 @@ 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/naming-conventions.md

@@ -0,0 +1,29 @@
+# Конвенции именования
+
+Testo может находить тесты по паттернам именования — атрибуты не нужны.
+
+Распознаваемые паттерны:
+
+- **Класс + Метод** — суффикс `*Test` на классе и префикс `test*` на методах
+- **Функция** — префикс `test*` на функции
+
+```php
+final class UserServiceTest
+{
+    public function testCreatesUser(): void { /* ... */ }
+
+    public function testDeletesUser(): void { /* ... */ }
+
+    public function testUpdatesProfile(): void { /* ... */ }
+}
+
+function testEmailValidator(): void { /* ... */ }
+```
+
+## Когда использовать
+
+Используйте конвенции именования, когда:
+
+- Предпочитаете **неявное** обнаружение тестов без дополнительных атрибутов
+- Мигрируете с PHPUnit или других фреймворков с похожими паттернами
+- Хотите, чтобы тесты были узнаваемы по именам с первого взгляда

ru/docs/test-attribute.md

@@ -39,5 +39,3 @@ function checks_environment(): void { /* ... */ }
 - Хотите **явно** объявлять тесты без привязки к именам
 - Имя метода/функции не следует конвенции с префиксом `test`
 - Предпочитаете обнаружение по атрибутам, а не по конвенциям
-
-Атрибут можно комбинировать с [конвенциями именования](./naming-conventions) в одном проекте.