[rulkc] [PATCH v3 08/40] landau-linux: maintenance: Drop 'upstream/mainline' English-ism from text
Dmitry Rokosov
rockosov at rulkc.org
Wed Jul 29 16:37:33 MSK 2026
From: Serge Semin <fancer.lancer at gmail.com>
It's just "original repo", "source repo", "origin", etc. Use these more
correct alternatives instead or just drop if it's appropriate.
Signed-off-by: Serge Semin <svsemin at unistemlab.com>
---
landau-linux/maintenance.md | 80 +++++++++++++++++++------------------
1 file changed, 41 insertions(+), 39 deletions(-)
diff --git a/landau-linux/maintenance.md b/landau-linux/maintenance.md
index beefcac0ea5c..d407793f83a9 100644
--- a/landau-linux/maintenance.md
+++ b/landau-linux/maintenance.md
@@ -14,7 +14,7 @@ published: true
### 🎯 Цель
-Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов LANDAU Linux с отслеживанием апстрим-ядра Linux.
+Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов LANDAU Linux с отслеживанием оригинального репозитория ядра Linux.
### Глоссарий
V - VERSION - major версия ядра Linux
@@ -34,7 +34,7 @@ Bundle - в общем случае это полный набор измене
`landau-next` - это ветка для работы всех мейтейнеров вместе. В ней разрешаются конфликты и собираются все MR вместе для создания ветки `landau-V.P.y`.
`landau-next` - это force-push ветка, которая меняется при каждом старте нового RMW
-### 🪞 Апстрим-зеркала
+### 🪞 Зеркала оригинальных репозиториев Linux
На сервере `https://git.rulkc.org` поддерживаются постоянно обновляемые зеркала:
@@ -55,8 +55,8 @@ VERSION.PATCHLEVEL.SUBLEVEL.lXYZ
| Компонент | Пример | Описание |
|-----------|--------|----------|
| `VERSION` | `7` | Мажорная версия ядра |
-| `PATCHLEVEL` | `0` | Минорная версия |
-| `SUBLEVEL` | `12` | Номер стабильного обновления апстрима |
+| `PATCHLEVEL` | `0` | Минорная версия ядра |
+| `SUBLEVEL` | `12` | Номер стабильного обновления ядра |
| `lXYZ` | `l0`, `l1` | Сборочный номер LANDAU Linux |
@@ -87,22 +87,24 @@ v7.0.lXYZ
graph LR
A[Создание ветки<br>landau-7.0.y] --> B[Активная разработка<br>и выпуск релизов]
B --> C{Тип поддержки?}
- C -->|Обычное ядро| D[EOL апстрима →<br>ветка архивируется]
- C -->|LTS ядро| E[Поддержка до EOL апстрима<br>только исправления]
+ C -->|Обычное ядро| D[EOL исходной версии →<br>ветка архивируется]
+ C -->|LTS ядро| E[Поддержка до EOL исходной версии<br>только исправления]
```
| Стадия | Действие |
|--------|----------|
-| 🆕 Создание | От тега апстрим-релиза |
+| 🆕 Создание | В момент релиза базовой версии ядра Linux |
| 🔧 Разработка | Ветка `landau-7.0.y` |
-| 🛑 Окончание поддержки | Апстрим достигает EOL |
+| 🛑 Окончание поддержки | Исходная версия достигает EOL |
| 🐢 LTS | Только исправления (без новых фич) |
---
## 📅 4. График релизов
-### ⏱️ Апстрим-график
+### ⏱️ Цикл релизов ядра Linux
+
+В оригинальном репозитории ядра Linux поддерживается следующий цикл разработки:
| Фаза | ⏰ Длительность | 📝 Описание |
|------|----------------|-------------|
@@ -111,7 +113,7 @@ graph LR
| RC-тестирование | 7-8 недель | Тестирование кандидатов на релиз |
| Финальный релиз | — | Публикация стабильного ядра |
-> ℹ️ **Важно**: Релизы LANDAU Linux отстают от апстрима на **1 patchlevel (SUBLEVEL)**.
+> ℹ️ **Важно**: Релизы LANDAU Linux отстают от последней версии ядра Linux на **1 patchlevel (SUBLEVEL)**.
---
@@ -121,24 +123,24 @@ graph LR
```mermaid
flowchart TD
- A[📦 Выход нового апстрим-релиза mainline] --> B[🔓 Открытие RMW LANDAU Linux<br>2 недели]
+ A[📦 Выход нового релиза ядра Linux] --> B[🔓 Открытие RMW LANDAU Linux<br>2 недели]
B --> C[🏷️ Создание тега v7.0.l-rc1]
C --> D[🧪 Фаза RC-тестирования<br>1 неделя на RC]
D --> E{Все тесты пройдены?}
E -->|Нет| F[🔧 Исправление ошибок]
F --> D
E -->|Да| G[✅ Релиз v7.0.l]
- G --> H[🔄 Интеграция SUBLEVEL<br>апстрима]
+ G --> H[🔄 Интеграция SUBLEVEL<br>стабильной версии ядра Linux]
H --> I[📈 Повышение версии<br>v7.0.1.l1]
```
-### 5.1 🆕 Новый релиз mainline
+### 5.1 🆕 Новый релиз стабильного ядра Linux
| Шаг | Действие |
|-----|----------|
-| 1 | Создать ветку `landau-7.0.y` от тега апстрим-релиза |
+| 1 | Создать ветку `landau-7.0.y` от первого релиза стабильного ядра Linux |
| 2 | Применить LANDAU-специфичные патчи |
-| 3 | Установить `VERSION`, `PATCHLEVEL`, `SUBLEVEL` по апстриму |
+| 3 | Оставить оригинальные значения `VERSION`, `PATCHLEVEL`, `SUBLEVEL` |
| 4 | Оставить `EXTRAVERSION` пустым (используется `.lX` формат) |
| 5 | Создать тег `v7.0.l-rc1` |
@@ -157,12 +159,12 @@ flowchart TD
2. Создать финальный аннотированный тег `v7.0.l`
3. Опубликовать релиз
-### 5.4 🔄 Интеграция апстрим-обновлений SUBLEVEL
+### 5.4 🔄 Интеграция обновлений SUBLEVEL
| Шаг | Действие | Пример |
|-----|----------|--------|
-| 1 | Определить новый `SUBLEVEL` из апстрим-тега | `v7.0.1` |
-| 2 | Смержить апстрим-изменения | `git merge v7.0.1` |
+| 1 | Определить новый `SUBLEVEL` из тега в оригинальном репозитории | `v7.0.1` |
+| 2 | Забрать изменения из GIT-ветки репозитория LTS | `git merge v7.0.1` |
| 3 | Повысить LANDAU-версию | `l` → `l1` |
| 4 | Обновить версию | `v7.0.1.l1` |
| 5 | Выпустить релиз | Публикация тега |
@@ -171,7 +173,7 @@ flowchart TD
## 🐢 6. Политика в отношении LTS
-Мейнтейнеры LANDAU Linux приняли решение **нативно поддерживать LTS-версии** апстрим-ядра.
+Мейнтейнеры LANDAU Linux приняли решение **нативно поддерживать LTS-версии** ядра Linux.
### ⚠️ Ограничения LTS-поддержки
@@ -188,8 +190,8 @@ flowchart TD
| Тип ядра | Условие окончания поддержки |
|----------|------------------------------|
-| Обычное | Апстрим достигает EOL |
-| LTS | Поддержка продолжается до EOL апстрима (без добавления новых фич) |
+| Обычное | Исходный релиз достигает EOL |
+| LTS | Поддержка продолжается до EOL базовой версии (без добавления новых фич) |
Гарантировано LANDAU Linux Owners поддерживают одно последнее LTS ядро. Про остальные LTS ядра думаем при наличии ресурсов.
@@ -199,11 +201,11 @@ flowchart TD
| Область | Ответственность |
|---------|------------------|
-| 👁️ Мониторинг апстрима | Отслеживание новых релизов и RC-циклов |
+| 👁️ Мониторинг исходного репозитория | Отслеживание новых релизов и RC-циклов |
| 📦 Применение патчей | Интеграция LANDAU-специфичных изменений ядра |
| 🏷️ Управление тегами | Создание аннотированных тегов в формате `vX.Y.lZ` |
| 🧪 Координация RC | Организация тестирования кандидатов на релиз |
-| 🔒 Безопасность | Мониторинг и применение апстрим-исправлений безопасности |
+| 🔒 Безопасность | Мониторинг и применение исправлений безопасности |
| 📝 Документирование | Ведение changelog для каждого LANDAU-релиза |
---
@@ -212,7 +214,7 @@ flowchart TD
### Исходные данные
-Апстрим выпускает ядро **`6.12.0`**
+Выпущено ядро Linux версии **`6.12.0`**
### 📍 Пошаговый пример
@@ -226,13 +228,13 @@ flowchart TD
| 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` | — |
+| 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` архивируется | — |
+| 9 | Исходная версия `7.0.x` получает статус EOL | Ветка `landau-7.0.y` архивируется | — |
#### 🔄 Детальное описание процесса
-1. **Выход нового стабильного релиза upstream kernel** (например, `v7.0` по результатам 7 недель стабилизации)
+1. **Выход нового стабильного релиза ядра Linux** (например, `v7.0` по результатам 7 недель стабилизации)
2. **Открытие RMW LANDAU Linux** — берём 2 недели на свой релиз LANDAU Linux:
- Затаскиваем патч-серии (MR) в ветку `landau-next`, на основе `v7.0`
- Там же происходит решение всех конфликтов
@@ -246,15 +248,15 @@ flowchart TD
- Вся дальнейшая поддержка этой версии ведётся в `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`**
+ - Переключается на шаг 1, когда в исходном репозитории Linux выходит новый стабильный релиз (например, `v7.1`)
+7. **Интеграция новых изменений SUBLEVEL из исходной стабильной версии ядра Linux**:
+ - Если в исходном репозитории меняется SUBLEVEL (например, `7.0.1`), мы интегрируем данный релиз в **`landau-7.0.y`**
- Повышаем свою версию: `v7.0.1.l1`
- - То есть повышается версия LANDAU Linux, а SUBLEVEL становится равным upstream SUBLEVEL
+ - То есть повышается версия LANDAU Linux, а SUBLEVEL получает новое значение согласно интегрированным изменениям
8. **Развитие стабильной версии**:
- Стабильная версия LANDAU Linux `v7.0` ведётся в ветке `landau-7.0.y`
9. **Окончание поддержки релиза**:
- - Поддержка релиза ветки LANDAU Linux заканчивается, когда версия основного ядра больше не тегируется как stable на kernel.org (например, `7.0` достигла EOL)
+ - Поддержка релиза ветки LANDAU Linux заканчивается, когда версия основного ядра больше не имеет статус стабильной на kernel.org (например, `7.0` достигла статуса EOL)
10. **LTS-поддержка**:
- Если основное ядро уходит в LTS, LANDAU поддерживает LTS до конца
- Приносятся только фиксы LANDAU Linux (без новых фич) и новые SUBLEVEL
@@ -266,16 +268,16 @@ flowchart TD
```mermaid
flowchart TD
- A[Выход нового<br>stable релиза upstream<br>например, v7.0] --> B[Открытие RMW LANDAU<br>2 недели]
+ A[Выход нового<br>стабильного релиза ядра Linux<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]
+ F --> G[Ожидание нового<br>стабильного релиза ядра Linux]
+ G --> H[Выходит стабильный релиз<br>с новым SUBLEVEL,<br>например, 7.0.1]
H --> I[Интеграция в landau-7.0.y:<br>v7.0.1.l1]
- I --> J{Апстрим EOL?}
+ I --> J{Исходная версия EOL?}
J -->|Нет| H
J -->|Да| K[Архивация ветки<br>landau-7.0.y]
```
@@ -312,9 +314,9 @@ TODO
| Ресурс | URL |
|--------|-----|
-| 📦 Репозиторий LANDAU | `https://git.rulkc.org/pub/scm/landau` |
-| 🪞 Зеркала апстрима | `https://git.rulkc.org` |
-| 🔗 Апстрим-ядро | `https://kernel.org` |
+| 📦 Репозитории LANDAU | `https://git.rulkc.org/pub/scm/landau` |
+| 🪞 Зеркала репозиториев Linux| `https://git.rulkc.org` |
+| 🔗 Оригинальные репозитории Linux | `https://kernel.org` |
---
--
2.48.1
More information about the rulkc
mailing list