Contributing

🤝 Contributing

Главная · Тестирование

Спасибо за интерес к проекту! Полный текст — в CONTRIBUTING.md.

Коротко

1. Обсудите изменение в Issues или Discussions.
2. Форкните репозиторий, создайте ветку от main.
3. Убедитесь, что весь конвейер зелёный:

composer ci          # статанализ + линтеры + все тестовые сьюты
composer infection   # мутационное тестирование

Требования к изменениям

• Код — PHP 8.1+, declare(strict_types=1), PSR-12; имена — английские, PHPDoc — на русском.
• Тесты — на каждое изменение: happy-path и пути отказа; покрытие каждого файла и MSI не должны упасть (пороги — в Testing).
• Конфиги анализаторов менять нельзя — чините причину, а не сообщение.
• Коммиты — малые, атомарные, <type>: суть в повелительном наклонении.
• Волатильные числа в документации не хардкодятся — composer docs:sync.

Релизный процесс

SemVer; каждое изменение — строка в CHANGELOG.md (Keep a Changelog), ломающие изменения — в UPGRADING.md. Мейнтейнер собирает релиз тегом vX.Y.Z + GitHub Release; Packagist обновляется автоматически.