Участие в разработке

На этой странице

Исходники профилей и сборочные скрипты дистрибутива не публикуются. Помочь проекту можно правками сайта и документации, а также проверкой тестового offline-образа на своём оборудовании.

Внутренние изменения

Эти правила относятся к команде, работающей с репозиторием дистрибутива.

Сначала разобраться, почему текущее состояние такое, какое есть. Часть странностей в профиле объясняется поведением archiso или Calamares, поэтому git log и комментарии в файлах важнее первого впечатления.
Сделать минимальную правку, которая решает задачу. Если изменение меняет рантайм, собрать затронутые редакции и загрузить образ: QEMU достаточно.
Прогнать проверки перед коммитом:
```
./scripts/lint.sh
```
Закоммитить одну логическую правку. Формат Conventional Commits, короткий заголовок. Тело добавляется только тогда, когда в заголовок оно не помещается, а история не переписывается.

Непроверенное не считается готовым

Если сборка, загрузка в QEMU или другой тест не запускались, так и пишется: не проверено. Выдавать ожидаемое за проверенное нельзя.

Как помочь проекту

Проверка live-образов

Проверить Plasma и LXQt из опубликованного offline-образа на своём оборудовании: сеть и Wi-Fi, звук, печать, внешние экраны, установка на диск. Найденное полезно даже без готового исправления.

Обратная связь

Сообщить об ошибке в тексте, неясной инструкции или проблеме при тестировании через задачи сайта.

Документация

Тексты сайта лежат в отдельном репозитории lycoris-site. Правки в документации идут по тем же правилам.

Что стоит знать

Внутренний репозиторий держится на нескольких договорённостях, подробности есть в архитектуре:

списки пакетов редакций только дополняют base, удалять пакеты из общего профиля нельзя, для файлов есть remove.list
оверлей airootfs заменяет файл целиком, построчных слияний конфигураций нет
метаданные редакции задаются в profiledef.overrides.sh, править profiledef.sh через sed нельзя
одноразовые скрипты для проверок лежат в /tmp или work/, в Git они не попадают

Задачи, которые сейчас в работе, перечислены в дорожной карте.