[docs] Результаты экспресс-совещания

George V. Kouryachy george на altlinux.org
Пн Апр 20 15:57:16 MSD 2009


На экспресс-совещани "что делать с проектом документации"
было, по большому счёту, затронуто две темы:
- ALDConvert: тяжёлые последствия мечтательной беспечности
- Модульность: не все модули одинаково похожи

Поясняю. По первой теме: на ALDConvert висит куча багов, некоторые из
них -- весьма критические. Сейчас upstream пытается перетащить
ALDConvert на работу с unicode-представлением (и, соответственно, с любой
кодировкой текста). Если есть ещё какие-то важные пожелания к
ALDConvert, просьба повысить их важность в bugzilla.

По второй теме. Хороша или плоха модульная структура документации, но
выигрыша от самих модулей нет никакого, т. к. для разных дистрибутивов
они всегда выглядят по-разному. Пытаться вводить какие-то изменяемые и
неизменяемые части прямо в формате документа -- верный путь к его
неподдерживаемости. Предлагается обратное решение: хранение цельных
кусков сходной документации в git-архиве (master), а профилирование
делать в виде унаследованных basnch-ей.

Чего здесь не хватает:
- Архитектуры веток git: была идея о трёхуровневой архитектуре:
  master -> branch X.Y -> Distro Name X.Y
- Дисциплины по внесению правок и проведению их по веткам (какого сорта
  правки в какие ветка делать и как потом проводить merge-и)
- Технического описаниния: какие команды git делать для реализации
  дисциплины 

Отдельное спасибо bosyarsh@ за совет изучить дисциплину работы с кодом в
ядре Linux.

Вопрос: кто возьмётся за исследование в этой области?

Отдельно хочу заметить, что модульность имеет одно преимущество: модуль
собирается не три часа с использованием половины Сизифа.

[2esyr] Стоит подписаться на docs на .

-- 
			George V. Kouryachy (aka Fr. Br. George)
			mailto:george at altlinux_org


Подробная информация о списке рассылки docs