Add "Why Testo?" documentation

Author: roxblnfk

.vitepress/config.mts

@@ -25,6 +25,7 @@ export default defineConfig({
             {
               text: 'Introduction',
               items: [
+                { text: 'Why Testo?', link: '/docs/why-testo' },
                 { text: 'Getting Started', link: '/docs/getting-started' },
               ],
             },
@@ -60,6 +61,7 @@ export default defineConfig({
             {
               text: 'Введение',
               items: [
+                { text: 'Почему Testo?', link: '/ru/docs/why-testo' },
                 { text: 'Начало работы', link: '/ru/docs/getting-started' },
               ],
             },

docs/why-testo.md

@@ -0,0 +1,88 @@
+# Why Testo?
+
+Testo (pronounced [test-oh], meaning "dough" in many languages) is an extensible testing framework for PHP. Built for scenarios requiring complete customization of the testing process: SDKs, framework tools, complex integrations.
+
+Unlike other testing frameworks, Testo provides everything at once: familiar and convenient PHP syntax, unprecedented extensibility and customizability, and a simple yet powerful architecture based on a minimal core and middleware system.
+
+You can mold it into any testing infrastructure you need.
+
+## History
+
+Testo was born from the need for an extensible testing framework that could adapt to the complex requirements of modern PHP projects. In brief:
+
+- Previously, to wrap test execution with custom logic, we relied on overriding the `TestCase::runTest()` method, which, although marked with `@internal` annotation, had existed for many years without semantic changes. It was a perfect extension point.
+- However, in versions [10.5.46](https://github.com/sebastianbergmann/phpunit/commit/8f0f8205e3a38675392da55afc573c6bb6a43f4e), [11](https://github.com/sebastianbergmann/phpunit/issues/5254), and 12, this method became `private`.
+- Appeals to maintainers [don't work](https://github.com/sebastianbergmann/phpunit/issues/6389). [Even these ones](https://github.com/sebastianbergmann/phpunit/issues/6381).
+- PEST also faced this problem. What did they do? Simply [overrode some PHPUnit classes in their own namespace](https://github.com/pestphp/pest/tree/bc57a84e77afd4544ff9643a6858f68d05aeab96/overrides). But this is a fragile solution, so PEST additionally [set conflicts in composer.json](https://github.com/pestphp/pest/blob/bc57a84e77afd4544ff9643a6858f68d05aeab96/composer.json#L33) to prevent breaking PHPUnit updates.
+
+## Testo Philosophy
+
+### Developer's Full Control
+
+From Testo's perspective, **tests are the developer's property, not the framework's**. All metadata and operational data needed by the framework are stored and processed separately.
+
+Therefore:
+- Test classes **don't need to extend** `TestCase`
+- Test cases don't run themselves and don't even know their name in the test environment
+- You can use the constructor however you want
+- Tests can even be ordinary functions!
+
+```php
+#[Test]
+function simpleTest(): void
+{
+    Assert::true(true);
+}
+```
+
+### Extensibility
+
+Testo is built on a simple idea: **a small core with a set of DTOs and contracts, and all functionality is built on top of middleware and event system**.
+
+The core simply builds several pipelines from middleware, and then do whatever you want. Every framework feature is middleware or event handlers:
+- Attributes in general
+- Data providers
+- Inline testing
+- Assertion system (`Assert`, `Expect`)
+- CLI rendering and TeamCity
+
+### Well-Designed API
+
+Instead of a bloated `Assert` facade with ~2300 lines (as in PHPUnit), Testo provides:
+- **`Assert`** — for assertions (checked here and now)
+- **`Expect`** — for expectations (checked after test completion)
+- **Pipe assertions** — grouping by types for cleaner code:
+
+```php
+// Strings
+Assert::string($string)->contains("str");
+
+// Files
+Assert::file("foo.txt")->notExists();
+
+// Exceptions
+Expect::exception(Failure::class)
+    ->fromMethod(Service::class, 'process')
+    ->withMessage("foo bar");
+```
+
+Testo comes with a [PhpStorm/IntelliJ IDEA plugin](https://plugins.jetbrains.com/plugin/28842-testo) that provides all the familiar functionality including test running, navigation, and debugging.
+
+## Who Is Testo For?
+
+Testo is built for those who:
+- Develop **frameworks** and need deep test integration.
+- Create **SDKs** with specific testing requirements.
+- Build **complex systems** where PHPUnit doesn't provide the needed flexibility.
+- Want **full control** over testing infrastructure.
+- Prefer PHP syntax over JS.
+
+## What's Next?
+
+Testo is in active development and moving toward version 1.0.0. We're open to ideas and suggestions from the community.
+
+Join the development on [GitHub](https://github.com/php-testo/testo).
+
+---
+
+> We believe developers should have full control over their testing environment, and Testo delivers exactly that.

ru/docs/why-testo.md

@@ -0,0 +1,88 @@
+# Почему Testo?
+
+Testo (произносится [тесто], что означает «тесто» во многих языках) — расширяемый фреймворк тестирования для PHP. Создан для сценариев, требующих полной кастомизации процесса тестирования: SDK, инструменты фреймворков, сложные интеграции.
+
+В отличие от других фреймворков тестирования, Testo предоставляет всё сразу: привычный и удобный PHP-синтаксис, беспрецедентную расширяемость и кастомизируемость, а также простую, но мощную архитектуру на основе минимального ядра и системы middleware.
+
+Вы можете слепить из него любую инфраструктуру тестирования, которая вам нужна.
+
+## История создания
+
+Testo родился из потребности в расширяемом фреймворке тестирования, который мог бы адаптироваться к сложным требованиям современных PHP-проектов. Подробнее о мотивации создания Testo [читайте здесь](https://www.notion.so/PHPUnit-28a5a7ab4c6c80c18d64f562da4aeca4), но вкратце:
+
+- Раньше, чтобы обернуть запуск теста своей логикой, мы опирались на переопределение метода `TestCase::runTest()`, который хоть и был помечен аннотацией `@internal`, но многие годы существовал и семантически не менялся. Это была прекрасная точка для расширения.
+- Однако, в версиях [10.5.46](https://github.com/sebastianbergmann/phpunit/commit/8f0f8205e3a38675392da55afc573c6bb6a43f4e), [11](https://github.com/sebastianbergmann/phpunit/issues/5254) и 12 этот метод стал `private`.
+- Обращения к автору PHPUnit [не работают](https://github.com/sebastianbergmann/phpunit/issues/6389). [Даже такие](https://github.com/sebastianbergmann/phpunit/issues/6381).
+- В PEST тоже столкнулись с этой проблемой. Что они сделали? Просто [переопределил некоторые классы PHPUnit в своём неймспейсе](https://github.com/pestphp/pest/tree/bc57a84e77afd4544ff9643a6858f68d05aeab96/overrides). Но это хрупкое решение, поэтому в PEST дополнительно [выставлены конфликты в composer.json](https://github.com/pestphp/pest/blob/bc57a84e77afd4544ff9643a6858f68d05aeab96/composer.json#L33), чтобы не допустить ломающего обновления PHPUnit.
+
+## Философия Testo
+
+### Полный контроль разработчика
+
+С позиции Testo, **тесты — это владение разработчика, а не фреймворка**. Вся метаинформация и оперативные данные, нужные фреймворку, хранятся и обрабатываются в стороне.
+
+Поэтому:
+- Тестовым классам **не нужно наследоваться** от `TestCase`
+- Тест-кейс не запускает сам себя и даже не знает своё имя в тестовой среде
+- Вы можете использовать конструктор как угодно
+- Тестами могут быть даже обычные функции!
+
+```php
+#[Test]
+function simpleTest(): void
+{
+    Assert::true(true);
+}
+```
+
+### Расширяемость
+
+Testo построен на простой идее: **небольшое ядро с набором DTO и контрактов, а весь функционал выстраивается на базе middleware и системы событий**.
+
+Ядро просто выстраивает несколько pipelines из middleware, а дальше делай что хочешь. Любая фича фреймворка это middleware или бработчики событий:
+- Атрибуты в целом
+- Дата-провайдеры
+- Inline-тестирование
+- Система утверждений (`Assert`, `Expect`)
+- CLI рендеринг и TeamCity
+
+### Продуманное API
+
+Вместо раздутого фасада `Assert` на ~2300 строк (как в PHPUnit), Testo предоставляет:
+- **`Assert`** — для утверждений (проверяются здесь и сейчас)
+- **`Expect`** — для ожиданий (проверяются после завершения теста)
+- **Пайповые ассерты** — группировка по типам для чистоты кода:
+
+```php
+// Строки
+Assert::string($string)->contains("str");
+
+// Файлы
+Assert::file("foo.txt")->notExists();
+
+// Исключения
+Expect::exception(Failure::class)
+    ->fromMethod(Service::class, 'process')
+    ->withMessage("foo bar");
+```
+
+Testo поставляется с [плагином для PhpStorm/IntelliJ IDEA](https://plugins.jetbrains.com/plugin/28842-testo), в котором есть весь привычный функционал с запуском тестов, навигацией и отладкой.
+
+## Для кого Testo?
+
+Testo создан для тех, кто:
+- Разрабатывает **фреймворки** и нуждается в глубокой интеграции тестов.
+- Создаёт **SDK** со специфичными требованиями к тестированию.
+- Строит **сложные системы**, где PHPUnit не даёт нужной гибкости.
+- Хочет **полного контроля** над тестовой инфраструктурой.
+- Предпочитает синтаксис PHP, а не JS.
+
+## Что дальше?
+
+Testo находится в активной разработке и движется к версии 1.0.0. Мы открыты для идей и предложений от сообщества.
+
+Присоединяйтесь к обсуждению в [Telegram](https://t.me/spiralphp) или участвуйте в разработке на [GitHub](https://github.com/php-testo/testo).
+
+---
+
+> Мы верим, что разработчики должны иметь полный контроль над своей тестовой средой, и Testo предоставляет именно это.