Мы рады коду, документации, переводам и сообщениям об ошибках.
Перед началомредактировать
- Если изменение крупное или требует обсуждения, сначала откройте issue.
- Работайте в собственной ветке, созданной от
develop. - Делайте небольшие и содержательные коммиты.
- Обновляйте документацию, если меняются правила проекта.
Сообщение об ошибкередактировать
Откройте issue с:
- Чётким описанием проблемы.
- Шагами для воспроизведения.
- Версией CubicLauncher и операционной системы.
- Ссылкой на журнал на mclo.gs, если это применимо.
Коммитыредактировать
Формат:
text
<type>(<optional scope>): <short description>
[optional body]
[breaking change / issue reference]Основные типы: feat, fix, refactor, perf, style, docs, test, chore, i18n и core для бэкенда на Rust.
- Сообщения пишутся на испанском языке в инфинитиве или повелительном наклонении.
- Первая строка не должна превышать 72 символа.
- Описывайте что, а не как.
- Один коммит на одно логическое изменение.
- Отмечайте ломающие изменения с помощью
!илиBREAKING CHANGE:в теле.
Процесс работы с pull requestредактировать
- Создайте ветку от
develop. - Внесите изменение и обновите тесты.
- Запустите локальные проверки:bash
bun run lint bun run check bun run test:all cargo fmt --all --check cargo clippy --workspace -- -D warnings - Откройте PR в
developи назначьте хотя бы один ярлык. - Отвечайте на замечания новыми коммитами в той же ветке; не переписывайте историю без просьбы.
Ярлыки PRредактировать
| Ярлык | Назначение |
|---|---|
breaking | Изменение, нарушающее совместимость. |
feature | Новая видимая пользователю функция. |
core | Бэкенд на Rust. |
ui | Визуальные изменения в Svelte или CSS. |
i18n | Переводы или языковые файлы. |
bug / fix / patch | Исправления. |
perf | Производительность. |
test | Тесты. |
docs | Документация. |
chore / refactor / deps / ci | Поддержка проекта. |
ignore-for-release | Не должен попадать в список изменений. |
Соглашения о кодередактировать
- Rust:
rustfmtи Clippy без предупреждений. Ошибки сериализуются как{"code":"...","params":{...}}для i18n. - Svelte/TypeScript: руны Svelte 5, никакого
any,keyв блоках{#each}и$derivedдля вычисляемых значений. - CI: форматирование, линты и тесты выполняются в GitHub Actions; PR не переходит к полному ревью, пока всё не станет зелёным.
Переводыредактировать
Переводы ведутся в CubicLauncherDevs/Translations. Лаунчер включает es-ES и en-US как локальные резервные варианты.
Чтобы добавить новый ключ:
- Добавьте его в
src/lib/i18n/en-US.jsonиsrc/lib/i18n/es-ES.json. - В репозитории переводов отредактируйте
src/locales/*.json. - Увеличьте поле
versionкаждого изменённого языка. - Добавьте запись в
src/changelog.json. - Запустите
bun run build && bun run deployв Worker.
Чтобы заполнить отсутствующие ключи относительно en-US, используйте bun run sync-locales в репозитории переводов.