AstraDeploy/CONTRIBUTING.md

Contributing to AstraDeploy

Спасибо за интерес к проекту! Любой вклад welcome: фиксы багов, улучшения UX, новые ядра, новые локали.

Как разрабатывать

1. Склонируйте/проверьте локальный репозиторий.
2. Работайте в отдельной ветке (рекомендуется).
3. Изменения делайте минимальными и атомарными по смыслу.
4. Смотрите локаль: тексты и подсказки лучше держать в locales/*.sh, а не разбрасывать по скриптам.

Полезные принципы

• install.sh хранит общий lifecycle; ядра — в cores/*.sh.
• Не меняйте поведение без флага по умолчанию, если это может сломать автоматический режим.
• Для новых параметров:
  • добавьте парсинг в install.sh;
  • добавьте локализацию в locales/en.sh и locales/ru.sh;
  • проверьте сценарии --yes, --easy, --dry-run, --force-clean, --accept-license.
• При добавлении новых ядер:
  • создайте новый файл в cores/;
  • добавьте запись в manifests/cores.json;
  • обновите install.sh --help список ядер.

Стиль и формат

• Bash: избегайте сложных однострочников, лучше явные переменные и функции.
• Локали и тексты: используйте существующие ключи/шаблоны в locales.
• Логи: новые важные шаги добавляйте через info/warn/error из lib/logger.sh.

Отладка и проверки

• Для быстрого прогона используйте --dry-run.
• При проблемах с внешним окружением:
  • --debug покажет расширенные шаги;
  • просматривайте лог в /var/log/astra-deploy/.
• Проверки не должны ломать установку на старте — лучше мягко предупреждать и продолжать fallback-логикой.

Pull Request

1. Коротко опишите, что меняется и почему.
2. Приложите сценарий проверки (команды/флаги), который вы прогоняли.
3. Укажите совместимые ОС/ядра и известные ограничения.