[docs] Как нам реорганизовать heap

Artem Zolochevskiy =?iso-8859-1?q?artem=2Ezolochevskiy_=CE=C1_gmail=2Ecom?=
Пн Окт 6 14:23:27 MSD 2008


6 октября 2008 г. 13:17 пользователь Mikhail Gusarov
<dottedmag на altlinux.org> написал:
> Twas brillig at 13:13:11 06.10.2008 UTC+03 when artem.zolochevskiy на gmail.com did gyre and gimble:
>
>  >> 1. Новый docinfo, включающий всё, что требуется для генерации spec (и
>  >>   конверсии) и без родовых болячек.
>
>  AZ> а нужен ли он вообще. этот docinfo
>
> Ещё раз: где хранить метаинформацию?

Я не про то где, а про "зачем". Зачем нам нужна эта метаинфорамация?
Как сейчас -- для составления страничка с описаниями всех модулей
документации? На сегодняшний день -- это единственная сфера
применения.

>
>  >> 3. Комплекс скриптов для публикации по приёму в git новой версии доки.
>
>  AZ> - масса исходных форматов (уже писалось про это много выше)
>
> Уже решено. Heap как-то работал, следовательно здесь никакой проблемы нет.

нет. не работал. иначе мы бы тут сейчас не имели предмет разговора
:-). проблема есть.

>
>  AZ> Т.е. придётся решить проблему _зависимостей_ выпусков от
>  AZ> модулей. Если ранее это делалось на уровне rpm, то сейчас придётся
>  AZ> как-то городить зависимость одного git-репозитория от другого (если
>  AZ> мы ходим уметь публиковать документацию online без применения rpm).
>
> Это простая задача. Не зависимость git'а от git'а, зависимость выпуска
> от версии модуля.
>
> Depends: module1 (X.Y), module2 (Z.W), где в скобках - тэги в репозитории.
>

Где такого рода информацию хранить? Руками проставлять её тоже не
хотелось бы, где бы она не хранилась.


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