[docs] О документации в сизифе и не в сизифе
Artem Zolochevskiy
=?iso-8859-1?q?artem=2Ezolochevskiy_=CE=C1_gmail=2Ecom?=
Вт Сен 2 12:41:19 MSD 2008
2 сентября 2008 г. 11:30 пользователь Mikhail Gusarov
<dottedmag на altlinux.org> написал:
> Привет.
>
> По поводу https://bugzilla.altlinux.org/show_bug.cgi?id=16984 - хочу
> узнать позицию тех, кто занимается документацией, о наличии документов,
> которые нельзя пакетировать.
>
> Я считаю, что вся документация, которая относится к устройству Сизифа,
> как проекта (не как технологической платформы), в дистрибутивы/бранчи
> попадать не должна вообще, ибо мгновенно протухает и доставляет потом
> кучу головной боли. А учитывая, гм, "понимание" релиз-менеджеров, и в
> Сизиф поэтому эту документацию упаковывать опасно.
>
Моё мнение:
- в бранчи/дистрибутивы, ничего описывающее сизиф, конечно, попадать не должно
- в сам же Сизиф -- я ещё не определился.
* с одной стороны это верно, что быстро теряется актуальность
(но ведь можно наладить относительную автоматизацию обновления
пакета, до соответствия версии на wiki)
* с другой -- иметь документацию только online, портит жизнь тем, кто
не всю жизнь online
(тут я не знаю, насколько это актуальная проблема)
Подробная информация о списке рассылки docs