[rulkc] [PATCH v3 04/40] Add LANDAU Linux project overview and maintenance documentation

Thu Jul 30 13:13:12 MSK 2026

On Wed, 2026-07-29 at 16:37 +0300, Dmitry Rokosov wrote:
> +
> +### 5.1 🆕 Новый релиз mainline
> +
> +| Шаг | Действие |
> +|-----|----------|
> +| 1 | Создать ветку `landau-7.0.y` от тега апстрим-релиза |

Вот тут мне не очень понятно - может "Создать ветку `landau-7.0.l`" -
почему именно y ?

> +| 2 | Применить LANDAU-специфичные патчи |
> +| 3 | Установить `VERSION`, `PATCHLEVEL`, `SUBLEVEL` по апстриму |
> +| 4 | Оставить `EXTRAVERSION` пустым (используется `.lX` формат) |
> +| 5 | Создать тег `v7.0.l-rc1` |
> +
> +### 5.2 🧪 RC-тестирование
> +
> +| Параметр | Значение |
> +|----------|----------|
> +| ⏱️ Длительность | **1 неделя** на каждый RC |
> +| 🏷️ Кандидаты | `rc1`, `rc2`, `rc3` ... |
> +| 🎯 Фокус | Регрессионное тестирование, стабильность, валидация фич
> |
> +| 🔧 Исправления | Применяются непосредственно в ветку релиза |
> +
> +### 5.3 ✅ Финальный релиз
> +
> +1. Убедиться, что все критические проблемы решены
> +2. Создать финальный аннотированный тег `v7.0.l`
> +3. Опубликовать релиз
> +
> +### 5.4 🔄 Интеграция апстрим-обновлений SUBLEVEL
> +
> +| Шаг | Действие | Пример |
> +|-----|----------|--------|
> +| 1 | Определить новый `SUBLEVEL` из апстрим-тега | `v7.0.1` |
> +| 2 | Смержить апстрим-изменения | `git merge v7.0.1` |
> +| 3 | Повысить LANDAU-версию | `l` → `l1` |
> +| 4 | Обновить версию | `v7.0.1.l1` |
> +| 5 | Выпустить релиз | Публикация тега |
> +
> +---
> +
> +## 🐢 6. Политика в отношении LTS
> +
> +Мейнтейнеры LANDAU приняли решение **нативно поддерживать LTS-
> версии** апстрим-ядра.
> +
> +### ⚠️ Ограничения LTS-поддержки
> +
> +| ✅ Разрешено | ❌ Запрещено |
> +|--------------|--------------|
> +| Исправления безопасности | Бэкпорт новых фич |
> +| Критические багфиксы | Новые драйверы |
> +| Стабилизирующие патчи | Изменения подсистем |
> +| Документация | Любые не-багфиксы |
> +
> +> 📌 **Принцип**: Поддерживается тот Changelog, который был на
> момент отвода LTS основного ядра.
> +
> +### 🛑 Окончание поддержки
> +
> +| Тип ядра | Условие окончания поддержки |
> +|----------|------------------------------|
> +| Обычное | Апстрим достигает EOL |
> +| LTS | Поддержка продолжается до EOL апстрима (без добавления новых
> фич) |
> +
> +Гарантировано LANDAU Owners поддерживают одно последнее LTS ядро.
> Про остальные LTS ядра думаем при наличии ресурсов.
> +
> +---
> +
> +## 👤 7. Обязанности мейнтейнера
> +
> +| Область | Ответственность |
> +|---------|------------------|
> +| 👁️ Мониторинг апстрима | Отслеживание новых релизов и RC-циклов |
> +| 📦 Применение патчей | Интеграция LANDAU-специфичных изменений |
> +| 🏷️ Управление тегами | Создание аннотированных тегов в формате
> `vX.Y.lZ` |
> +| 🧪 Координация RC | Организация тестирования кандидатов на релиз |
> +| 🔒 Безопасность | Мониторинг и применение апстрим-исправлений
> безопасности |
> +| 📝 Документирование | Ведение changelog для каждого LANDAU-релиза
> |
> +
> +---
> +
> +## 📖 8. Пример полного цикла релиза
> +
> +### Исходные данные
> +
> +Апстрим выпускает ядро **`6.12.0`**
> +
> +### 📍 Пошаговый пример
> +
> +#### 👁️ Схема
> +
> +| Этап | Действие | Результат | Версия сборки |
> +|------|----------|-----------|---------------|
> +| 1 | Force push ветки `landau-next` на `v7.0` | `landau-next` | — |
> +| 2 | Старт RMW | `landau-next` | `N/A` |
> +| 3 | Создание RC1 | `v7.0.l-rc1` | `7.0.l-rc1` |
> +| 4 | Создание RC2 | `v7.0.l-rc2` | `7.0.l-rc2` |
> +| 5 | Создание RC3 | `v7.0.l-rc3` | `7.0.l-rc3` |
> +| 6 | **Финальный релиз** и **отвод ветки** | `v7.0.l`<br>`landau-
> 7.0.y` | `7.0.l` |
> +| 7 | Апстрим выпускает `7.0.1` | Слияние изменений в `landau-7.0.y`
> | — |
> +| 8 | Обновление версии | `v7.0.1.l1` | `7.0.1.l1` |
> +| 9 | Апстрим объявляет EOL для `7.0` | Ветка `landau-7.0.y`
> архивируется | — |
> +
> +#### 🔄 Детальное описание процесса
> +
> +1. **Выход нового стабильного релиза upstream kernel** (например,
> `v7.0` по результатам 7 недель стабилизации)
> +2. **Открытие RMW LANDAU** — берём 2 недели на свой релиз LANDAU:
> +   - Затаскиваем патч-серии (MR) в ветку `landau-next`, на основе
> `v7.0`
> +   - Там же происходит решение всех конфликтов
> +   - Формируются первые общие сборки ядра
> +3. **Выпуск RC-версий** (например, `v7.0.l-rc1`) — RC-релизы
> делаются в ветке `landau-next`
> +4. **Тестирование** — длится до 7 недель (может быть меньше):
> +   - Выпускаются RC-версии: `rc1`, `rc2`, `rc3` и т.д.
> +5. **Финальный релиз и отвод стабильной ветки**:
> +   - Выпускаем релиз `v7.0.l`
> +   - Отводим стабильную ветку **`landau-7.0.y`** от финального
> релиза
> +   - Вся дальнейшая поддержка этой версии ведётся в `landau-7.0.y`
> +6. **Завершение цикла `landau-next`**:
> +   - Ветка `landau-next` останавливает свой рост на первом релизе
> `v7.0.l`
> +   - Переключается на шаг 1, когда в upstream выходит новый
> стабильный релиз (например, `v7.1`)
> +7. **Интеграция SUBLEVEL из upstream**:
> +   - Если в upstream меняется SUBLEVEL (например, `7.0.1`), мы
> интегрируем данный релиз в **`landau-7.0.y`**
> +   - Повышаем свою версию: `v7.0.1.l1`
> +   - То есть повышается версия LANDAU, а SUBLEVEL становится равным
> upstream SUBLEVEL
> +8. **Развитие стабильной версии**:
> +   - Стабильная версия LANDAU `v7.0` ведётся в ветке `landau-7.0.y`
> +9. **Окончание поддержки релиза**:
> +   - Поддержка релиза LANDAU-ветки заканчивается, когда версия
> основного ядра больше не тегируется как stable на kernel.org
> (например, `7.0` достигла EOL)
> +10. **LTS-поддержка**:
> +    - Если основное ядро уходит в LTS, LANDAU поддерживает LTS до
> конца
> +    - Приносятся только фиксы LANDAU (без новых фич) и новые
> SUBLEVEL
> +11. **Гарантии поддержки**:
> +    - LANDAU Owners гарантированно поддерживают **одно последнее LTS
> ядро**
> +    - Про поддержку более старых LTS ядер думаем при наличии
> ресурсов
> +
> +#### 📊 Визуализация цикла
> +
> +```mermaid
> +flowchart TD
> +    A[Выход нового<br>stable релиза upstream<br>например, v7.0] -->
> B[Открытие RMW LANDAU<br>2 недели]
> +    B --> C[Приём MR в landau-next<br>на основе v7.0]
> +    C --> D[Выпуск RC1, RC2, RC3...<br>до 7 недель]
> +    D --> E{Тестирование пройдено?}
> +    E -->|Нет| D
> +    E -->|Да| F[Релиз v7.0.l<br><br>⚡ Отвод ветки<br><b>landau-
> 7.0.y</b>]
> +    F --> G[Ожидание нового<br>stable upstream]
> +    G --> H[Апстрим выпускает<br>новый SUBLEVEL,<br>например, 7.0.1]
> +    H --> I[Интеграция в landau-7.0.y:<br>v7.0.1.l1]
> +    I --> J{Апстрим EOL?}
> +    J -->|Нет| H
> +    J -->|Да| K[Архивация ветки<br>landau-7.0.y]
> +```
> +
> +#### 🏷️ Пример полной цепочки тегов
> +
> +Для ядра `7.0.x` в LANDAU:
> +
> +```
> +v7.0.l-rc1  →  v7.0.l-rc2  →  v7.0.l-rc3  →  v7.0.l
> +                                                  ↓
> +                                          отвод landau-7.0.y
> +                                                  ↓
> +                                          v7.0.1.l1  →  v7.0.2.l2 
> →  ...
> +```
> +
> +---
> +
> +### Требования к патчам
> +
> +TODO
> +
> +### Pull requests
> +
> +TODO
> +
> +### Maintainers B4 usage
> +
> +TODO
> +
> +---
> +
> +## 📚 9. Ссылки и ресурсы
> +
> +| Ресурс | URL |
> +|--------|-----|
> +| 📦 Репозиторий LANDAU | `https://git.rulkc.org/pub/scm/landau` |
> +| 🪞 Зеркала апстрима | `https://git.rulkc.org` |
> +| 🔗 Апстрим-ядро | `https://kernel.org` |
> +
> +---
> +
> +> 📌 **Актуальная версия документа**: 1.0  
> +> ✍️ **Поддерживается**: LANDAU Maintainers
> +> 📅 **Последнее обновление**: 2026
> +
> +[⬅️ Вернуться на страницу LANDAU Linux](./index.md)