Start with VitePress

Author: roxblnfk

.gitignore

@@ -0,0 +1,18 @@
+/.*/
+!/.github/
+
+# Dependencies
+/node_modules
+
+# VitePress build output
+.vitepress/dist
+.vitepress/cache
+
+# Misc
+.DS_Store
+*.local
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

README.md

@@ -0,0 +1,61 @@
+# Testo Documentation
+
+Documentation site for [Testo](https://github.com/php-testo/testo) - Modern PHP Testing Framework.
+
+Built with [VitePress](https://vitepress.dev/).
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Start dev server
+npm run dev
+
+# Build for production
+npm run build
+
+# Preview production build
+npm run preview
+```
+
+Dev server runs at `http://localhost:5173/`
+
+## Project Structure
+
+```
+docs/
+├── .vitepress/
+│   └── config.mts       # VitePress configuration
+├── pages/
+│   ├── en/              # Landing page (English)  -> /
+│   └── ru/              # Landing page (Russian)  -> /ru/
+├── docs/
+│   ├── en/              # Documentation (English)
+│   └── ru/              # Documentation (Russian)
+├── blog/
+│   ├── en/              # Blog articles (English)
+│   └── ru/              # Blog articles (Russian)
+└── public/              # Static assets (logo, images)
+```
+
+## Adding Content
+
+### New documentation page
+
+1. Create `docs/en/my-page.md` and `docs/ru/my-page.md`
+2. Add to sidebar in `.vitepress/config.mts`
+
+### New blog post
+
+1. Create `blog/en/my-post.md` and `blog/ru/my-post.md`
+2. Add link to `blog/en/index.md` and `blog/ru/index.md`
+
+## Deployment
+
+```bash
+npm run build
+```
+
+Output is in `.vitepress/dist/` - deploy to any static hosting.

blog/en/index.md

@@ -0,0 +1,7 @@
+# Blog
+
+Latest news and articles about Testo.
+
+## Articles
+
+- [Introducing Testo 1.0](./introducing-testo-1-0) - The first stable release of Testo

blog/en/introducing-testo-1-0.md

@@ -0,0 +1,64 @@
+# Introducing Testo 1.0
+
+We are excited to announce the first stable release of Testo - a modern PHP testing framework designed for simplicity and speed.
+
+## Why Testo?
+
+PHP testing has come a long way, but we felt there was room for something new. Testo was built with these goals in mind:
+
+- **Developer Experience First** - Writing tests should feel natural and enjoyable
+- **Speed** - Parallel execution out of the box for faster feedback loops
+- **Modern PHP** - Built for PHP 8.1+ with full support for attributes and fibers
+
+## Key Features
+
+### Simple Test Syntax
+
+```php
+test('user can be created', function () {
+    $user = new User('John');
+
+    expect($user->name)->toBe('John');
+    expect($user->isActive())->toBeTrue();
+});
+```
+
+### Rich Assertions
+
+Testo comes with a comprehensive assertion library:
+
+```php
+expect($value)->toBe(42);
+expect($array)->toContain('item');
+expect($string)->toMatch('/pattern/');
+expect($callable)->toThrow(Exception::class);
+```
+
+### Parallel Execution
+
+Run tests in parallel to speed up your test suite:
+
+```bash
+vendor/bin/testo --parallel
+```
+
+## Getting Started
+
+Install Testo via Composer:
+
+```bash
+composer require --dev php-testo/testo
+```
+
+Check out the [Getting Started](/docs/en/getting-started) guide for more details.
+
+## What's Next?
+
+This is just the beginning. We have exciting features planned:
+
+- IDE plugins for PHPStorm and VS Code
+- Code coverage reporting
+- Snapshot testing
+- And much more!
+
+Join us on [GitHub](https://github.com/php-testo/testo) and be part of the journey.

blog/ru/index.md

@@ -0,0 +1,7 @@
+# Блог
+
+Новости и статьи о Testo.
+
+## Статьи
+
+- [Представляем Testo 1.0](./introducing-testo-1-0) - Первый стабильный релиз Testo

blog/ru/introducing-testo-1-0.md

@@ -0,0 +1,64 @@
+# Представляем Testo 1.0
+
+Мы рады объявить о выходе первого стабильного релиза Testo - современного фреймворка для тестирования PHP, созданного для простоты и скорости.
+
+## Почему Testo?
+
+Тестирование в PHP прошло долгий путь, но мы почувствовали, что есть место для чего-то нового. Testo был создан с этими целями:
+
+- **Опыт разработчика на первом месте** - Написание тестов должно быть естественным и приятным
+- **Скорость** - Параллельное выполнение из коробки для быстрой обратной связи
+- **Современный PHP** - Создан для PHP 8.1+ с полной поддержкой атрибутов и файберов
+
+## Ключевые возможности
+
+### Простой синтаксис тестов
+
+```php
+test('пользователь может быть создан', function () {
+    $user = new User('Иван');
+
+    expect($user->name)->toBe('Иван');
+    expect($user->isActive())->toBeTrue();
+});
+```
+
+### Богатые утверждения
+
+Testo поставляется с полной библиотекой утверждений:
+
+```php
+expect($value)->toBe(42);
+expect($array)->toContain('item');
+expect($string)->toMatch('/pattern/');
+expect($callable)->toThrow(Exception::class);
+```
+
+### Параллельное выполнение
+
+Запускайте тесты параллельно для ускорения:
+
+```bash
+vendor/bin/testo --parallel
+```
+
+## Начало работы
+
+Установите Testo через Composer:
+
+```bash
+composer require --dev php-testo/testo
+```
+
+Смотрите руководство [Начало работы](/docs/ru/getting-started) для подробностей.
+
+## Что дальше?
+
+Это только начало. У нас запланированы интересные возможности:
+
+- Плагины для PHPStorm и VS Code
+- Отчёты о покрытии кода
+- Snapshot-тестирование
+- И многое другое!
+
+Присоединяйтесь к нам на [GitHub](https://github.com/php-testo/testo) и станьте частью путешествия.

docs/en/getting-started.md

@@ -0,0 +1,55 @@
+# Getting Started
+
+This guide will help you get started with Testo in your PHP project.
+
+## Installation
+
+Install Testo via Composer:
+
+```bash
+composer require --dev php-testo/testo
+```
+
+## Writing Your First Test
+
+Create a test file in your `tests` directory:
+
+```php
+<?php
+
+use function Testo\{test, expect};
+
+test('basic math works', function () {
+    expect(1 + 1)->toBe(2);
+});
+
+test('strings can be concatenated', function () {
+    $greeting = 'Hello, ' . 'World!';
+    expect($greeting)->toBe('Hello, World!');
+});
+```
+
+## Running Tests
+
+Run your tests using the Testo CLI:
+
+```bash
+vendor/bin/testo
+```
+
+You should see output like:
+
+```
+PASS  tests/ExampleTest.php
+  ✓ basic math works
+  ✓ strings can be concatenated
+
+Tests: 2 passed
+Time:  0.05s
+```
+
+## Next Steps
+
+- Learn about [Assertions](/docs/en/assertions)
+- Explore [Test Organization](/docs/en/organizing-tests)
+- Configure [Parallel Execution](/docs/en/parallel)

docs/ru/getting-started.md

@@ -0,0 +1,55 @@
+# Начало работы
+
+Это руководство поможет вам начать работу с Testo в вашем PHP проекте.
+
+## Установка
+
+Установите Testo через Composer:
+
+```bash
+composer require --dev php-testo/testo
+```
+
+## Написание первого теста
+
+Создайте файл теста в директории `tests`:
+
+```php
+<?php
+
+use function Testo\{test, expect};
+
+test('базовая математика работает', function () {
+    expect(1 + 1)->toBe(2);
+});
+
+test('строки можно объединять', function () {
+    $greeting = 'Привет, ' . 'Мир!';
+    expect($greeting)->toBe('Привет, Мир!');
+});
+```
+
+## Запуск тестов
+
+Запустите тесты с помощью CLI Testo:
+
+```bash
+vendor/bin/testo
+```
+
+Вы увидите вывод:
+
+```
+PASS  tests/ExampleTest.php
+  ✓ базовая математика работает
+  ✓ строки можно объединять
+
+Tests: 2 passed
+Time:  0.05s
+```
+
+## Следующие шаги
+
+- Изучите [Утверждения](/docs/ru/assertions)
+- Узнайте про [Организацию тестов](/docs/ru/organizing-tests)
+- Настройте [Параллельное выполнение](/docs/ru/parallel)