[docs] Re: docs plans

[Anton V. Boyarshinov]

On Fri, 26 Dec 2003 15:17:30 +0300 Anton Farygin
 wrote:
> >>Для примера - у нас есть классный электронный справочник man.
> >>Попробуйте в нем быстро найти утилиты, с помощью которых
> >можно>получить: 1) имя каталога из полного пути к файлу
> >>2) количество строк в файле
> >>3) утилиту, уменьшающую размер текстового файла методом
> >замены>пробелов на табуляцию.
> > 
> > 
> > Первые 2 не интересно -- я знаю ответ. Третье -- элементарно:
> > 
> > apropos spaces 
> 
> А где оно описано в документации ???

Мораль -- должны быть описаны способы доступа к существующей
электронной документации. С другой стороны -- man описан, стало
быть и apropos в man man найти несложно.

> > Боюсь даже подумать о том, сколько временибы ушло на поиск в
> > бумажной книге.
> 
> Немного ;-)

Не уверен.
 
> К тому же книга отличается от электронного документа тем, что с
> ней можно работать не имея под рукой комьютера.
> 
> Что многие и делают.

ИМХО есть 2 вида документации.

1 Описание концепций (описание особенностей дистрибутива тоже
сюда входит)

2 Справочник.

С первым видом документации можно и нужно общаться без
компьютера. Со вторым -- практически никогда. Мне никогда не
приходило в голову почитать man strftime или man 5 crontab на сон
грядущий. А вот PDF specification -- запросто. 

-- 
mailto:boyarsh на mail.ru
mailto:boyarsh на ru.echo.fr
 15:36:00  up 23:50, 11 users,  load average: 0.06, 0.15, 0.13