[rulkc] [PATCH v3 24/40] landau-linux: maintenance: Wrap up the text to be up to 80-char per line

Wed Jul 29 16:37:49 MSK 2026

It's a tough task to track changes in the long lines even with diff usage.
Let's apply the 80-char line constraints to the document at least for the
chapters body so to make diff's more readable.

Co-developed-by: Serge Semin <svsemin at unistemlab.com>
Signed-off-by: Serge Semin <svsemin at unistemlab.com>
Signed-off-by: Dmitry Rokosov <rockosov at rulkc.org>
---
 landau-linux/maintenance.md | 74 ++++++++++++++++++++++++++++++-------
 1 file changed, 60 insertions(+), 14 deletions(-)

diff --git a/landau-linux/maintenance.md b/landau-linux/maintenance.md
index 388412b67aed..387d450cfc37 100644
--- a/landau-linux/maintenance.md
+++ b/landau-linux/maintenance.md
@@ -5,8 +5,9 @@ published: true
 
 # 📋 Манифест процесса сопровождения ядра LANDAU Linux
 
-> **LANDAU Linux** — форк <u>ядра Linux</u> с собственной схемой версионирования и предсказуемым циклом релизов.
-> Этот документ описывает формальный процесс сопровождения (maintenance) проекта.
+> **LANDAU Linux** — форк <u>ядра Linux</u> с собственной схемой версионирования
+> и предсказуемым циклом релизов.  Этот документ описывает формальный процесс
+> сопровождения (maintenance) проекта.
 
 ---
 
@@ -14,7 +15,8 @@ published: true
 
 ### 🎯 Цель
 
-Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов LANDAU Linux с отслеживанием оригинального репозитория ядра Linux.
+Обеспечить стабильный, предсказуемый и документированный процесс выпуска релизов
+LANDAU Linux с отслеживанием оригинального репозитория ядра Linux.
 
 ### 📖 Глоссарий
 
@@ -179,7 +181,8 @@ flowchart TB
 | 🔧 Поддержка | Сбор исправлений ошибок в GIT-ветке `landau-V.P.y` |
 | 🐢 Окончание поддержки | Исходная версия достигает EOL |
 
-> В базовом представлении _поддержка_ подразумевает периодическую синхронизацию `landau-V.P.y` с исходной GIT-веткой `linux-V.P.y`.
+> В базовом представлении _поддержка_ подразумевает периодическую синхронизацию
+> `landau-V.P.y` с исходной GIT-веткой `linux-V.P.y`.
 
 ---
 
@@ -196,7 +199,9 @@ flowchart TB
 | RC-тестирование | 7-8 недель | Тестирование кандидатов на релиз |
 | Финальный релиз | — | Публикация стабильного ядра |
 
-> ℹ️ **Важно**: Поскольку релизы LANDAU Linux базируются на стабильных релизах ядра Linux, то текущий цикл разработки всегда отстаёт от последней версии ядра Linux на **1 PATCHLEVEL**.
+> ℹ️ **Важно**: Поскольку релизы LANDAU Linux базируются на стабильных релизах
+> ядра Linux, то текущий цикл разработки всегда отстаёт от последней версии ядра
+> Linux на **1 PATCHLEVEL**.
 
 ---
 
@@ -288,7 +293,10 @@ flowchart TB
 | 6 | Обновить `EXTRAVERSION` на `l-rc1` и создать коммит "LANDAU Linux V.P.l-rc1" |
 | 7 | Отметить коммит аннотированным тегом `vV.P.l-rc1` |
 
-> ℹ️ Переменная `EXTRAVERSION` в стабильных релизах ядра Linux остаётся пустым, потому может быть использована для сохранения версий LANDAU Linux. При этом оригинальные значения `VERSION`, `PATCHLEVEL`, `SUBLEVEL` в дальнейшем сохраняются для индикации версии исходного ядра Linux.
+> ℹ️ Переменная `EXTRAVERSION` в стабильных релизах ядра Linux остаётся пустым,
+> потому может быть использована для сохранения версий LANDAU Linux. При этом
+> оригинальные значения `VERSION`, `PATCHLEVEL`, `SUBLEVEL` в дальнейшем
+> сохраняются для индикации версии исходного ядра Linux.
 
 | Параметр | Значение |
 |----------|----------|
@@ -315,7 +323,8 @@ flowchart TB
 | 🏷️ Релизы | `l-rc1`, `l-rc2`, `l-rc3` ... |
 | 🔧 Исправления | Применяются непосредственно в ветку релиза по запросу нижестоящих ментейнеров |
 
-> ℹ️ Стабилизация GIT-ветки `landau-next` (отсуствие выявленных ошибок в очреденом RC-цикле) символизирует окончание этапа RC и выход на релиз.
+> ℹ️ Стабилизация GIT-ветки `landau-next` (отсуствие выявленных ошибок в
+> очреденом RC-цикле) символизирует окончание этапа RC и выход на релиз.
 
 ### 5.3 ✅ Релиз LANDAU Linux
 
@@ -351,7 +360,11 @@ flowchart TB
 | 🏷️ Релизы | `l1`, `l2`, `l2`, ...  |
 | 🔧 Исправления | Применяются по запросу нижестоящих ментейнеров в рамках корректирующих релизов |
 
-Мейнтейнеры LANDAU Linux приняли решение **нативно поддерживать стабильные и LTS-версии** ядра Linux до получения статуса EOL. Однако гарантировано корректирующие изменения LANDAU Linux портируются в LANDAU Linux на основе последней LTS-версии ядра Linux. Портирование изменений в более ранние версии возможно при наличии ресурсов.
+Мейнтейнеры LANDAU Linux приняли решение **нативно поддерживать стабильные и
+LTS-версии** ядра Linux до получения статуса EOL. Однако гарантировано
+корректирующие изменения LANDAU Linux портируются в LANDAU Linux на основе
+последней LTS-версии ядра Linux. Портирование изменений в более ранние версии
+возможно при наличии ресурсов.
 
 ⚠️ Особенности интеграции изменений в стабильную и LTS версии LANDAU Linux:
 
@@ -378,7 +391,9 @@ flowchart TB
 | 🏷️ Релизы | `lZ` |
 | 🔧 Исправления | Не применяются |
 
-Поддержка **стабильной и LTS версий** LANDAU Linux завершается либо вместе с получением статуса EOL исходной версии ядра Linux, либо после выпуска релиза LANDAU Linux, основанного на последней LTS-версии ядра Linux.
+Поддержка **стабильной и LTS версий** LANDAU Linux завершается либо вместе с
+получением статуса EOL исходной версии ядра Linux, либо после выпуска релиза
+LANDAU Linux, основанного на последней LTS-версии ядра Linux.
 
 ---
 
@@ -393,9 +408,26 @@ flowchart TB
 | 🔒 Безопасность | Мониторинг и применение исправлений безопасности |
 | 📝 Документирование | Ведение changelog для каждого LANDAU-релиза |
 
-### Личные репозитории ментейнеров
+### 🏗️ Личные репозитории ментейнеров
 
-В личных репозиториях ментейнеры хранят и развивают собственные форки ядра Linux с подведомственным им набором изменений. В целом, способ организации персональных репозиториев ментейнеры могут выбирать самостоятельное. Например, можно разделить независимые изменения на GIT-ветки по подсистемам и отправлять MR с каждым из них, либо предварительно объединить их в единую GIT-ветку и отправить один целостный MR. При этом необходимо придерживаться правила **преемственности предыдущих изменений и минимизации merge-конфликтов**. То есть GIT-ветка, отправляемая в MR главному ментейнеру, должна сохранять историю предыдущих изменений LANDAU Linux и их исправлений, а также содержать последнюю версию оригинальной версии ядра Linux, для которого готовится релиз LANDAU Linux. Для реализации такого требования удобно использовать подход **двойного слияния**, суть которого в том, чтобы сначала ментейнеры своих репозиториев LANDAU Linux (sub-LANDAU Linux) выполнили слияние своих GIT-веток с `landau-next`, разрешили все конфликты и лишь потом отправляли MR в рамках этапа RMW:
+В личных репозиториях мейнтейнеры хранят и развивают собственные форки ядра
+Linux с подведомственным им набором изменений.
+
+В целом, способ организации персональных репозиториев мейнтейнеры могут выбирать
+самостоятельно. Например, можно разделить независимые изменения на GIT-ветки по
+подсистемам и отправлять MR с каждым из них, либо предварительно объединить их в
+единую GIT-ветку и отправить один целостный MR.  При этом необходимо
+придерживаться правила **преемственности предыдущих изменений и минимизации
+merge-конфликтов**. То есть GIT-ветка, отправляемая в MR главному мейнтейнеру,
+должна сохранять историю предыдущих изменений LANDAU Linux и их исправлений, а
+также содержать последнюю версию оригинальной версии ядра Linux, для которого
+готовится релиз LANDAU Linux.
+
+Для реализации такого требования удобно использовать подход **двойного
+слияния**, суть которого в том, чтобы сначала мейнтейнеры своих репозиториев
+LANDAU Linux (sub-LANDAU Linux) выполнили слияние своих GIT-веток с
+`landau-next`, разрешили все конфликты и лишь потом отправляли MR в рамках этапа
+RMW.
 
 ```mermaid
 ---
@@ -428,9 +460,19 @@ gitGraph
     commit id: "LANDAU Linux V.P.l-rc1" tag: "vV.P.l-rc1"
 ```
 
-Таким образом, основная нагрузка по исправлению конфликтов ложится на нижестоящих ментейнеров. Главному ментейнeру остаётся лишь собрать все MR в `linux-next`. Если и в этом случае возникают сложные конфликты, то главный ментейнер вправе попросить выполнить повторный цикл **двойного слияния**, чтобы кросс sub-LANDAU Linux конфликты были разешены на стороне нижестоящих ментейнеров.
+Таким образом, основная нагрузка по исправлению конфликтов ложится на
+нижестоящих ментейнеров. Главному ментейнеру остаётся лишь собрать все MR в
+`linux-next`. Если и в этом случае возникают сложные конфликты, то главный
+ментейнер вправе попросить выполнить повторный цикл **двойного слияния**, чтобы
+кросс sub-LANDAU Linux конфликты были разешены на стороне нижестоящих
+ментейнеров.
 
-К тому же опционально ментейнеры могут выполнять поддержку GIT-веток с патч-сетами для последующей отправки изменений в оригинальный репозиторий ядра Linux. До момента интеграции патч-сеты могут "поглощать" исправления и стилистические изменения в процессе перебазирования на новую версию ядра Linux. Это упрощает сопровождение таких GIT-веток, минимизируя лог изменений, который к тому же является лишним при интеграции в ядро Linux.
+Опционально ментейнеры могут выполнять поддержку GIT-веток с патч-сетами для
+последующей отправки изменений в оригинальный репозиторий ядра Linux. До момента
+интеграции патч-сеты могут "поглощать" исправления и стилистические изменения в
+процессе перебазирования на новую версию ядра Linux.  Это упрощает сопровождение
+таких GIT-веток, минимизируя лог изменений, который к тому же является лишним
+при интеграции в ядро Linux.
 
 ---
 
@@ -438,7 +480,11 @@ gitGraph
 
 ### Исходные данные
 
-Выпущено ядро Linux версии **`7.0`**. Это означает, что в оригинальном репозитории ядра Linux изменения, добавленные в период окна слияния, достаточно стабилизировались, этап RC завершён, EXTRAVERSION принимает пустое значение, последний коммит символизирует релиз ядра Linux 7.0, а в GIT-репозитории стабильных и LTS веток появляется новая ветка `linux-7.0.y`.
+Выпущено ядро Linux версии **`7.0`**. Это означает, что в оригинальном
+репозитории ядра Linux изменения, добавленные в период окна слияния, достаточно
+стабилизировались, этап RC завершён, EXTRAVERSION принимает пустое значение,
+последний коммит символизирует релиз ядра Linux 7.0, а в GIT-репозитории
+стабильных и LTS веток появляется новая ветка `linux-7.0.y`.
 
 ### 📍 Пошаговый пример
 
-- 
2.48.1


