[docs] Re: rpm-публикации (Was: deleting alt-entities)

[Vitaly Ostanin]

On Thu, 12 Feb 2004 23:29:59 +0300
"Oleg A. Paraschenko" <olpa на xmlhack.ru> wrote:

<skipped/>

> > > > В Сизифе принято дробить пакеты для достижения более
> > > > гибких зависимостей
> > > 
> > >   Это великолепно когда есть возможность дробить. Но у нас
> > >   не сравнительно
> > > независимые пакеты ПО, но модульная документация, которая
> > > потенциально содержит перекрёстные связи. Нельзя вытащить
> > > просто FAQ или install, надо также положить базу
> > > olink-ссылок, всё что берётся по xinclude и ещё что-нибудь.
> > > Наверное, можно придумать подход в котором всё будет
> > > работать, но на реализацию уйдёт очень много усилий.
> > 
> > Всё не так сложно. База olink-ссылок минимальна, ссылок между
> > книгами вообще нет. К тому же базу ссылок можно собирать
> > отдельным пакетом, и отслеживать ситуации, когда прямую
> > ссылку сделать нельзя. Только можно давать ссылку просто на
> > название книги.
> 
>   Так или иначе, надо писать rpm spec. Вычитаем это из общего
>   объёма работ. Остаётся:
> 
> checkout от cvs: ничего
> 
> независимые пакеты: 1) ... 2) ... 3) ... etc, причём реализация
> некоторых из этих k) не особо очевидна
> 
>   Неудивительно, что монолитный вариант мне нравится больше.

Монолитные варианты многим нравятся, и многим удобнее, но только
до поры до времени. Практика показывает, что они
трудноподдерживаемы.

> > > > и возможностей обновления. Очевидно, что FAQ будет
> > > > обновляться чаще, чем install.
> > > 
> > >   Допустим, что так. И что?
> > 
> > Значит, придётся пересобирать. В случае отдельных книг
> > придётся пересобирать и качать только нужную.
> 
>   Ну и что? Те, кому может потребоваться пересобирать книгу, те
>   имеют cvs.

Совсем не факт. Для примера: кому-то понадобится собрать
часть DocBook TDG в pdf для распечатки. Да, можно добыть из cvs
DocBook, но гораздо удобнее иметь под рукой tarball.

> Остальные вряд ли будут заниматься обновлением документации
> (особенно, учитывая, что документацию всё равно никто не
> читает).

С последним утверждением мы боремся :)

>   Выгода от создания фичи = выгода от однократного
>   использования фичи *
> частота использования фичи. В данном случае, боюсь, это близко
> к нулю.

Выгода однозначна - простота поддержки и обновления, экономия
трафика и ресурсов сборки.

>   Кстати, не совсем в тему, но предлагаю также посмотреть:
> 
> Hard-assed Bug Fixin'
> http://joelonsoftware.com/articles/fog0000000014.html
> 
> As a software developer, fixing bugs is a good thing. Right?
> Isn't it always a good thing? No! Fixing bugs is only important
> when the value of having the bug fixed exceeds the cost of the
> fixing it.

В данном случае для меня это философия - я делаю не на
время/оптимальность усилий, а для собственного удовольстия, и
хотел бы сделать хорошо :)

> > Насколько я понимаю, избавление от "монстроидальности"
> > пакетов в пользу модульности - один из принципов в Sisyphus.
> > Поправьте меня, pls, если я не прав.
> 
>   У меня есть такое мнение, что docs -- это не Sisyphus. И то,
>   что они сейчас объединены -- это историческое наследие.

Sisyphus - средство разработки дистрибутивов/решений.
cvs docs - средство разработки документации (в основном - для
дистрибутивов).
Готовая документация будет жить в том числе и в Sisyphus, в виде
пакетов.

> > >   Зачем такое желание? Те, кому зачем-то нужно часто
> > >   пересобирать
> > > документацию, те имеют cvs. В какие-то определённые моменты
> > > времени можно делать "снимок" содержимого cvs в виде
> > > src.rpm, позволяя делать пересборку документации из
> > > "рекомендованной" версии cvs.
> > 
> > cvs - это средство разработки. Релиз должен собираться без
> > cvs.
> 
>   Не cvs, но снимок из cvs. Просто набор файлов.

Не всегда релиз можно сделать просто из снимка cvs, да это и не
важно. Исходники документов должны распростаняться не в виде
простого снимка из cvs, а в виде готового релиза. Документы
должны собираться из готового релиза. По-моему, это очевидно.

Господа, высказывайтесь, пожалуйста, а то мы с Олегом уже по
второму кругу пошли :)

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20040213/92e7828e/attachment.bin