[docs] О документации в сизифе и не в сизифе

Kirill Maslinsky =?iso-8859-1?q?kirill_=CE=C1_altlinux=2Eorg?=
Вт Сен 2 14:04:11 MSD 2008


On Tue, Sep 02, 2008 at 11:41:19AM +0300, Artem Zolochevskiy wrote:
> 2 сентября 2008 г. 11:30 пользователь Mikhail Gusarov
> <dottedmag на altlinux.org> написал:
> > Привет.
> >
> > По поводу https://bugzilla.altlinux.org/show_bug.cgi?id=16984 - хочу
> > узнать позицию тех, кто занимается документацией, о наличии документов,
> > которые нельзя пакетировать.
> >
> > Я считаю, что вся документация, которая относится к устройству Сизифа,
> > как проекта (не как технологической платформы), в дистрибутивы/бранчи
> > попадать не должна вообще, ибо мгновенно протухает и доставляет потом
> > кучу головной боли. А учитывая, гм, "понимание" релиз-менеджеров, и в
> > Сизиф поэтому эту документацию упаковывать опасно.
> >
> 
> Моё мнение:
> - в бранчи/дистрибутивы, ничего описывающее сизиф, конечно, попадать не должно
> - в сам же Сизиф -- я ещё не определился.
>  * с одной стороны это верно, что быстро теряется актуальность
>      (но ведь можно наладить относительную автоматизацию обновления
> пакета, до соответствия версии на wiki)
>  * с другой -- иметь документацию только online, портит жизнь тем, кто
> не всю жизнь online
>      (тут я не знаю, насколько это актуальная проблема)

Мне не очень нравится идея документации, которую нельзя паковать. 

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

Я согласен с позицией, что документацию по Сизифу как проекту не следует включать 
в пользовательские дистрибутивы. 
	
	Поскольку релиз-менеджеры оных дистрибутивов обычно "не в теме", можно
	предусмотреть технические средства предотвращения попадания
	соотв. пакетов документации в дистрибутивы -- например,
	выставить конфликт на что-нибуддь дистрибутивное или зависимость
	на что-то принципиально недистрибутивное. 

	(Кстати, это может быть и более общей задачей: пакеты, которые
	не должны попасть в дистрибутив)

-- 
Kirill Maslinsky
ALT Linux Team


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