Polish "Writing tests"

Author: roxblnfk

.vitepress/theme/style.css

@@ -1,3 +1,8 @@
+/* Reserve space for scrollbar to prevent layout shift */
+html {
+  scrollbar-gutter: stable;
+}
+
 /* Override VitePress brand colors with dough/testo colors */
 :root {
   --vp-c-brand-1: #d4a574;

docs/getting-started.md

@@ -91,8 +91,7 @@ final class CalculatorTest
 
 ### Key Points
 
-- The `#[Test]` attribute is used to mark test methods.
-- Test classes don't need to inherit from a base class.
+- The `#[Test]` attribute marks test methods, and test classes don't need to inherit from a base class. See [Writing Tests](./writing-tests) for more options.
 - Use the `Assert` facade for assertions and `Expect` for expectations.
 - Testo provides multiple attributes to extend testing capabilities (retry policies, exception handling, and more).
 

docs/writing-tests.md

@@ -1,10 +1,14 @@
 # Writing Tests
 
-Testo doesn't care where a test lives, as long as it can be wrapped in a Closure. Currently supported:
+Testo doesn't care where a test lives, as long as it can be wrapped in a Closure.
 
-- **Classes** — tests are methods in regular classes, no base class inheritance required.
-- **Functions** — tests can be standalone functions.
-- **[Inline Tests](./inline-tests)** — for simple pure functions, tests as attributes directly on the method being tested.
+## Where to Write Tests
+
+- **In methods** — in regular classes without `TestCase` inheritance.
+- **In functions** — in standalone functions outside classes.
+- **In attributes** — directly on the method being tested. See [Inline Tests](./inline-tests).
+
+## Test Discovery
 
 Depending on the configuration, Testo can discover tests in several ways:
 
@@ -13,3 +17,8 @@ Depending on the configuration, Testo can discover tests in several ways:
 - **Custom strategies** — you can implement your own test discovery, for example by function-call (like PEST, but without execution) or by class parent, like PHPUnit.
 
 All approaches can be combined in one project or even in one Test Suite.
+
+## Less Code
+
+- **Parameterization** — instead of copying a test for each data set, write one test and pass it different values via [data providers](./data-providers).
+- **Interceptor attributes** — extract repetitive boilerplate into reusable attributes.

ru/docs/getting-started.md

@@ -90,10 +90,9 @@ final class CalculatorTest
 
 ### Ключевые моменты
 
-- Атрибут `#[Test]` используется для пометки тестовых методов.
-- Тестовые классы не нужно наследовать от базового класса.
+- Атрибут `#[Test]` помечает тестовые методы, при этом классам не нужно наследовать базовый класс. Подробнее в разделе [Пишем тесты](./writing-tests).
 - Используйте фасад `Assert` для утверждений и `Expect` для ожиданий.
-- Testo предоставляет множество атрибутов для расширения возможностей тестирования (политики повторов, обработка исключений и другое)
+- Testo предоставляет множество атрибутов для расширения возможностей тестирования (политики повторов, обработка исключений и другое).
 
 ## Запуск тестов
 

ru/docs/writing-tests.md

@@ -1,17 +1,24 @@
 # Пишем тесты
 
-Для Testo без разницы, где находится тест, если его можно завернуть в Closure. Сейчас поддерживаются:
+Для Testo без разницы, где находится тест, если его можно завернуть в Closure.
 
-- **Классы** — тесты это методы обычных классов, наследование от базового класса не требуется.
-- **Функции** — тесты могут быть обычными функциями.
-- **[Встроенные тесты](./inline-tests)** — для простых чистых функций, тесты как атрибуты прямо на тестируемом методе.
+## Где писать тесты
 
----
+- **В методах** — в обычных классах без наследования от `TestCase`.
+- **В функциях** — в обычных функциях вне классов.
+- **В атрибутах** — прямо на тестируемом методе. См. [Встроенные тесты](./inline-tests).
 
-В зависимости от настроект, Testo может находить тесты несколькими способами:
+## Обнаружение тестов
+
+В зависимости от настроек, Testo может находить тесты несколькими способами:
 
 - **Явно** — [атрибут #\[Test\]](./test-attribute) помечает метод, функцию или класс.
 - **По конвенциям** — [соглашения об именовании](./naming-conventions), например методы `testSomething()` или классы `*Test`.
 - **Кастомные стратегии** — можно реализовать собственный способ поиска тестов, например по function-call (как в PEST, только без запуска) или по родителю класса, как в PHPUnit.
 
 Все подходы можно комбинировать в одном проекте или даже в одном Test Suite.
+
+## Меньше кода
+
+- **Параметризация** — вместо копирования теста для каждого набора данных, напишите один тест и передайте ему разные значения через [провайдеры данных](./data-providers).
+- **Атрибуты-интерцепторы** — выносите повторяющийся boilerplate в переиспользуемые атрибуты.