[docs] разница: модули и выпуски

[Kirill Maslinsky]

On Mon, Mar 17, 2008 at 03:03:32PM +0200, Artem Zolochevskiy wrote:
> hi all 

[...]

> Отсюда вывод. Нам надо:
> - или прекратить делать внутри модулей ссылки на другие модули
На самом деле вопрос в цене такой "битой ссылки". Т.е. если она 
устроена каким-то таким образом, что можно понять, какого модуля не
хватает и доустановить его, то не так страшно, что этот модуль не 
будет установлен сразу.

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

Думаю, тут две разных задачи: 

1. Делать более логичным разбиение материала на модули, выкидывать
ненужные ссылки в текстах модулей. В принципе, я согласен даже с
радикальной позицией, что ссылки на другие модули можно в текстах 
модулей запретить, так как по содержанию они там действительно
нежелательны -- это нарушение логической модульности. Всю логику
объединения модулей может нести на себе выпуск, действительно.

2. Автоматизировать поиск зависимостей на модули документации 
(в выпусках). 
Если ссылки между модулями будут разрешены, то при несоблюдении 
логической "модульности" автоматическое выставление зависимостей
может переплести модули в такой клубок, что ставиться они будут 
только одним комом, и больше никак, т.к. все будут цепочками
и циклами друг от друга зависеть. Это опять же подталкивает
к мысли о запрете ссылок между модулями. 

А автоматические зависимости на модули в выпуске вида, например,
docs(module_id) лично у меня не вызывают сомнений -- это было бы 
правильно. Вопрос только, кто бы их реализовал?

> PS
> Поясню из-за чего сыр-бор.
> Приходится весьма нудно и долго проверять глазками/ручками всё ли в порядке с 
> нашими ссылками/зависимостями. И раз или два это можно ещё сделать, но я 
> понемногу просто теряю обзор из-зи обилия дистрибутивов (а соответсвенно 
> и "выпусков").
> Пример:
> Выпуск docs-issue-distro имет ссылку на модуль docs-moduleA
> Всё тут замечательно. При сборке docs-issue-distro пакет автоматически 
> получает зависимость на docs-moduleA.
> Всё резко ломается, если сам docs-moduleA имеет ссылку внутри себя на 
> docs-moduleB. Как я уже сказал выше, модули наши НЕ имеет автоматики по 
> выставленю зависимостей.
> Вот тут то всё и ломается :( Решается "костылями" в виде ручного просмотра 
> ВСЕХ ссылок в рамках выпуска и выставления имён нужных пакетов в 
> docs-issue-distro в виде скрытых ссылок.
> Всё это хозяйство крайне проблематично отслеживать :(
> 
> Ещё раз:
> - или прекратить делать внутри модулей ссылки на другие модули
> - или преобразовать такие модули в выпуски
> - или как можно быстрее реализовать автоматическое выставление зависимостей у 
> модулей, содержащих ссылки на други модули. В этом случае придётся дать более 
> точное определение того, чем же отличаются выпуски от модулей. Ибо в этом 
> случае техническая разница стирается.
> 
> -- 
> Артём Золочевский
> _______________________________________________
> docs mailing list
> docs на lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/docs

-- 
С уважением,
Кирилл Маслинский
Альт Линукс
руководитель издательских проектов