[docs] Re: docs plans

[Anton V. Boyarshinov]

On Thu, 25 Dec 2003 15:48:43 +0300 Anton Farygin
 wrote:

>  Ты опять собираешься отправлять пользователя гулять по куче 
> документации, собранной с разных мест.. с расхождениями по
> версиям программ, неоостветсвию особенностям и т.д.

Самостоятельно документировать весь дистрибутив невозможно. То
есть возможно, но нереально, так как требует совершенно
нереального финансирования.

> Или покажи пример документации, в которой описано, как на лету
> сменить разрешение в XFree ?

Разработчик, которому это надо, найдёт ответ без труда.

> >>Т.е. - фактически нам нужно иметь алфавитный справочник
> >команд>(программ, библиотек, функций) и некую книгу,
> >рассказывающую о>том как это все использовать для решения тех
> >или иных задач.
> > 
> > 
> > Ты поинтересуйся историей юниксов.  С полудюжинами томиков
> > тех самых manpages (по три тыщи страниц томик).  И почему
> > даже с коммерческими юниксами стали в итоге поставлять
> > online-версии.
> 
> Правильно.. а никто и не говорит, что все будет в печатном
> варианте.
> 
> Для печатного варианта - нужен способ формировать из различных
> разделов online документации - печатный вариант.

Я не уверен, что это хорошая идея. Нормальные книги так не
делаются. Книга -- это не просто выборка части от целого.

> > И это правильно.  И претензий к Сашиному видению вопроса у
> > меня_нет_ (глобальных).  А к твоему -- есть.  Глобальные.
> 
> Т.е. - ты хочешь сказать, что документация, идущая с Master 2.2
> - тебя полностью устраивает ?

Нет. Но она не устравивает _меня_ тем, что заявленного в "docs
plans" там нет и бОльшей частью по независящим от avp
обстоятельствам. Предложения же rider меня устраивают ещё меньше,
чем существующая документация.

Антон
-- 
mailto:boyarsh на mail.ru
mailto:boyarsh на ru.echo.fr
 15:48:00  up 2 min, 10 users,  load average: 1.44, 0.55, 0.20