[docs] Re: docs plans

Anton Farygin rider на altlinux.com
Чт Дек 25 19:34:19 MSK 2003


Anton V. Boyarshinov wrote:
> On Thu, 25 Dec 2003 15:48:43 +0300 Anton Farygin
>  wrote:
> 
> 
>> Ты опять собираешься отправлять пользователя гулять по куче 
>>документации, собранной с разных мест.. с расхождениями по
>>версиям программ, неоостветсвию особенностям и т.д.
> 
> 
> Самостоятельно документировать весь дистрибутив невозможно. То
> есть возможно, но нереально, так как требует совершенно
> нереального финансирования.
> 
> 
>>Или покажи пример документации, в которой описано, как на лету
>>сменить разрешение в XFree ?
> 
> 
> Разработчик, которому это надо, найдёт ответ без труда.

Если знает где искать - да. Если не знает - то никогда не найдет, а 
напишет в список расылки и будет ждать очень долго ответа.


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

Согласен. Но - тогда придется следовать пути подготовки документации 
методом написания _хорошо поддерживаемых_ в дальнейшим книг. А это 
означает практически полный отказ от документирования различных 
графических утилит, разрабатываемых не силами ALT'а.

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

Пока документацией занимается avp - от него зависит все.

Rgds,
Rider




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