[docs] Re: документация по docbook

[Michael Shigorin]

On Fri, Feb 25, 2005 at 03:42:39PM +0300, Alexandre Prokoudine wrote:
> >>Специфичный для alt тег один, <alt:distro>. Его нужно просто
> >>вычистить из всех текстов, если мы документируем Сизиф.
> >А смысл документировать сизиф?
> Смотря что понимать под документированием Сизифа.
> (1) Документирование функционирования Сизифа как дерева разработки?
> (2) Документирование софта в составе Сизифа?
> Если мне не изменяет память, в начале всех недавних изменений речь шла о 
> (3) документировании решений на основе Сизифа.

Видишь ли, документирование анстейбла напоминает построение
скребонёба на как минимум морене, а то и бархане, при этом
начиная со стеклянной крыши и в четыре с половиной руки.

Если я разработчик -- мне глубоко фиолетово, будут ли правильно
расставлены запятые в доке.  Главное, чтобы она была АКТУАЛЬНОЙ
и ТОЧНОЙ.  Например, то, что Дима писал про rpm*alt плюс то, что
там менялось с последнего обновления rpm.tex.

Если я пользователь Sisyphus -- либо я хочу _тоже_ любую доку,
в любом виде, абы полезную, либо я курю что-то не то и за желание
странного (печатной или эквивалентного уровня качества
документации по sisyphus-yyyymmdd) плачу.  Или иду нафиг.

Кирилл, цели-то какие?  И какие приоритеты, если опубликованный
некогда список принять за реальный для наличных сил?

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/