Add translation guidelines for documentation and refine test terminology

Author: roxblnfk

CLAUDE.md

@@ -0,0 +1,51 @@
+# Гайдлайн по переводу документации
+
+## Основные принципы
+
+1. **Естественность важнее дословности**
+   - Перевод должен звучать так, как говорят русские разработчики
+   - Избегать кальки с английского, если это звучит неестественно
+
+2. **Сохранять технические термины**
+   - Не переводить названия классов, методов, атрибутов, пакетов
+   - Оставлять код примеры без изменений
+
+## Терминология
+
+### Устоявшиеся термины
+
+| Английский | ❌ Неправильно | ✅ Правильно |
+|------------|----------------|--------------|
+| test case | тестовый случай | тест, тест-кейс |
+| data provider | поставщик данных | провайдер данных |
+| dataset | — | датасет / набор данных (оба допустимы) |
+| callable | вызываемый | вызываемый объект (в контексте) |
+| closure | закрытие | замыкание |
+
+### Специфичные фразы
+
+| Английский | ❌ Неправильно | ✅ Правильно |
+|------------|----------------|--------------|
+| Simple as that | Просто как это | Вот так просто |
+| right on the method | прямо на методе | непосредственно над методом |
+
+## Стилистика
+
+1. **Избегать канцеляризмов**
+   - Вместо "тестовый случай" → "тест"
+   - Вместо "осуществить проверку" → "проверить"
+
+2. **Сохранять тон оригинала**
+   - Если оригинал неформальный и дружелюбный — перевод тоже
+   - Технические термины оставлять точными
+
+3. **Порядок слов**
+   - Использовать естественный русский порядок слов
+   - Не копировать английскую структуру предложения
+
+## Проверка качества
+
+Перед финализацией перевода задать вопросы:
+- Так ли говорят русские разработчики?
+- Звучит ли фраза естественно при чтении вслух?
+- Сохранен ли технический смысл оригинала?

ru/docs/sample-module.md

@@ -4,7 +4,7 @@
 
 В настоящее время включает:
 - **DataProvider** — для динамических, сложных наборов данных
-- **TestInline** — для простых, статических тестовых случаев прямо на методе
+- **TestInline** — для простых, статических тестов прямо на методе
 
 ## Провайдер данных
 
@@ -62,7 +62,7 @@ public function testAddition(int $a, int $b, int $expected): void { ... }
 public function testUser($data): void { ... }
 ```
 
-Вызываемые объекты особенно полезны для разделения логики загрузки данных. Например, загрузка тестовых случаев из JSON/CSV файлов в выделенный класс позволяет сохранить код тестов чистым.
+Вызываемые объекты особенно полезны для разделения логики загрузки данных. Например, загрузка тестов из JSON/CSV файлов в выделенный класс позволяет сохранить код тестов чистым.
 
 ### Метки и описания
 
@@ -80,16 +80,16 @@ public function userDataProvider(): array
 ```
 
 Используйте `DataProvider`, когда:
-- У вас много тестовых случаев (10+)
+- У вас много тестов (10+)
 - Данные генерируются динамически или загружаются из внешних файлов
-- Тестовым случаям нужны метки или описания для ясности
+- Тестам нужны метки или описания для ясности
 - Требуется сложная логика настройки для тестовых данных
 
 **Примечание:** `DataProvider` является дополнением к обычным тестам (методам, помеченным `#[Test]`). Он предоставляет данные существующим тестовым методам.
 
 ## Встроенные тесты
 
-`TestInline` использует другой подход — он объявляет тестовые случаи как атрибуты непосредственно на тестируемом методе, без необходимости отдельного тестового класса.
+`TestInline` использует другой подход — он объявляет тесты как атрибуты непосредственно на тестируемом методе, без необходимости отдельного тестового класса.
 
 Это может быть полезно для простых чистых функций, где отдельный тестовый файл был бы избыточным. Также хорошо работает для тестирования приватных вспомогательных методов — вы можете тестировать их напрямую без изменения видимости. При прототипировании `TestInline` дает вам немедленную валидацию без переключения контекста на тестовый файл.
 
@@ -100,7 +100,7 @@ public function userDataProvider(): array
 TestInline(array $arguments, mixed $result = null)
 ```
 
-Объявите тестовые случаи прямо на методе:
+Объявите тесты непосредственно над методом:
 
 ```php
 use Testo\Sample\TestInline;
@@ -114,9 +114,9 @@ public function sum(int $a, int $b): int
 }
 ```
 
-Каждый атрибут `TestInline` запускает метод с заданными аргументами и проверяет результат. Просто как это.
+Каждый атрибут `TestInline` запускает метод с заданными аргументами и проверяет результат. Вот так просто.
 
-`TestInline` работает лучше всего с 2-10 статическими тестовыми случаями, где ожидаемое поведение очевидно из пар входных/выходных данных. Для больших наборов тестов или случаев, требующих пояснений, рассмотрите написание отдельного теста в директории `tests/` с использованием `DataProvider`.
+`TestInline` работает лучше всего с 2-10 статическими тестами, где ожидаемое поведение очевидно из пар входных/выходных данных. Для больших наборов тестов или случаев, требующих пояснений, рассмотрите написание отдельного теста в директории `tests/` с использованием `DataProvider`.
 
 ### Тестирование приватных методов