[docs] ВНИМАНИЕ: отчёт и насущные проблемы

[Alexandre Prokoudine]

Michael Shigorin пишет:
> On Tue, Jan 11, 2005 at 04:08:11PM +0300, Fr. Br. George wrote:
> 
>>Встаёт вопрос об автоматизированной машинистке. Народ спасается
>>введением разнообразных wiki. Результат -- у этого народа
>>замечательная и актуальная документация, но только в формате
>>HTML. Что-либо бумажное из этого получается очень грустное, так
>>как все известные мне wiki-документы размечаются не структурно,
>>а с точки зрения внешнего вида и гипертекстовости.
> 
> 
> Я, наверное, скажу ересь... но IMHO вывод -- надо регулировать
> объём печатной и онлайновой документации.
 >
 > С предпочтением второго.
 >

Нет, это не ересь.

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

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

Как только в книжке появляются длинные перечисления команд, я немедленно 
лезу в компьютер и открываю электронную версию доки -- чтобы 
скопипастить команды в консоль.

Это мой use case. Ваш, уважаемые коллеги, может сильно отличаться от него.

<offtopic>
Вообще говоря, именно печатную документацию удобнее читать в том виде, в 
каком она была для "Утёса" -- нормальная тетрадь, которую не страшно 
развернуть, опасаясь некачественного клея. Но стоимость уже одной такой 
тетради закрывает этот вопрос ещё на долгое время.
</offtopic>

А.П.