[docs] Re: docs plans

[Anton Farygin]

Michael Shigorin wrote:
> On Thu, Dec 25, 2003 at 08:29:22PM +0300, Anton Farygin wrote:
> 
>>>>Для примера - у нас есть классный электронный справочник man.
>>>>Попробуйте в нем быстро найти утилиты, с помощью которых
>>>>можно получить:
>>>>1) имя каталога из полного пути к файлу
>>>>2) количество строк в файле
>>>>3) утилиту, уменьшающую размер текстового файла методом
>>>>замены пробелов на табуляцию.
> 
> 
> "Дурак в минуту назадает столько вопросов, что мудрый и за месяц
> не ответит".  Извини, вспомнилось.
> 
> Ты предлагаешь к (уже документированной) инструментальной среде
> применить "виндовый" подход с готовыми ответами на все вопросы?
> 
> (это провокация :)

Я предлагаю совместно выработать требования к документации, внося свои 
предложения и тем самым провоцируя некое обсуждение, в итоге которого 
рождаются, в том числе, и здравые мысли... (если ты еще не понял).

> 
> На самом деле рациональное зерно есть и оно понятно, но ты его
> упорно пытаешься похоронить в груде бессмысленного труда и его
> плодов.
> 
> А надо всего лишь дать пользователю ключевые слова.
> 
>   строки:
>     посчитать -- wc
>     найти -- grep
>     поменять -- sed, subst
>   файлы:
>    найти -- find, locate
>    посчитать строчки -- wc

Да... что то вроде этого.
Очень, кстати, здравая идея...


> 
>  
> 
>>>В плане разделов Руководства пользователя ясно вижу у себя:
>>>5. Вводный курс по работе с командной строкой.
>>
>>Какой же он вводный ??? ;-)
>>Насколько я знаю - утилита, заменяющая пробелы на табуляцию -
>>вообще _нигде_ не описана, кроме как в man'ах.
> 
> 
> Ну там ей и место.  Надо объяснить, как пользоваться apropos, и
> показать пару примеров поиска информации "на пальцах".



> 
> 
>>Т.е. - вводный курс преввращается в полноценное руководство по
>>coreutils, bash, sed, awk и т.д. ?
> 
> 
> Ну ты к этому подводишь.  А я скажу, что мне такое не нужно --
> круг людей, которым оно поможет и для которых оно было бы
> немаловажным фактором в пользу коробочного дистро -- шире, чем
> круг тех, кто нам с тобой лекции прочитать и мануалы написать в
> состоянии.
> 
> Информации-то много, а вот хороших введений и индексов -- мало.
> Впрочем, последнее гугль закрывает.

Не забывай, что интернет, пока еще, есть не у всех. И это - важно !!!!

Rgds,
Rider