[Junior] Junior коробка

[Kirill Maslinsky]

On Wed, Dec 05, 2007 at 12:45:51PM +0200, Artem Zolochevskiy wrote:
> В сообщении от Monday 03 December 2007 12:51:26 Владимир Черный написал(а):
> > 03.12.07, Kirill Maslinsky<kirill на altlinux.org> написал(а):
> > > Добрый день!
> > >
> > > Думаю, обсуждение вопросов документации пора переносить в рассылку,
> > > оно уже достаточно содержательно для этого.
> > >
> > > On Mon, Dec 03, 2007 at 11:56:48AM +0300, Владимир Черный wrote:
> > > > 03.12.07, Kirill Maslinsky<kirill на altlinux.org> написал(а):
> > > > > On Sat, Dec 01, 2007 at 01:16:43PM +0300, Alexey Rusakov wrote:
> > > > > > On Fri, 30 Nov 2007 19:33:41 +0300
> > > > > > Владимир Черный wrote:
> > >
> > > [...]
> > >
> > > > > > > Документация
> > > > > > > 1. Рук-во по установке
> > > > > > > 2. Рук-во пользователя вмещающее
> > > > > > > - базовые знания по Линукс
> > > > > > > - имеющиеся инстр. на программы
> > > > > > > 3.  Книга для учителя (рук-во администратора, но не только)
> > > > > > > - базовые сведения по настройке-администрированию системы
> > > > > > > - легенда (словарик) по программам - что какая программа делает
> > > > > > > 4. Листочек-раскладушка(гормошка?) - quick reference по командам
> > > > > > > Линукс
> 
> Как мыслите, ключики на эту раскладушкувключать?
> Или кратенько как-то так:
> название -- описание (из мана)
> пример использования

Я бы предложил рассматривать такую раскладушку не как справочник (для
которого все равно не хватит места, справочником работает man), а как 
набор типичных примеров (use case'ов) на самые распространённые задачи
пользователя, которые удобно решать в командной строке. 
Т.е. даже предпочтительно с этой точки зрения не столько описывать 
отдельные команды, сколько целые _выражения_, м.б. с включением
конвейера, циклов и т.п.

Ну вот скажем, дать один пример на типичную задачу, которую очень удобно 
решать в командной строке -- массовое переименование или конвертацию
файлов (скажем, с помощью convert или iconv). Можно даже попробовать 
описание конструкции в обобщенном виде, скажем, 

$ for i in <нечто> ; do <что-то> $i ${i%%.бла}.бла ; done

Хотя может быть обобщенная запись будет для многих сложной (найдутся те,
кто так и напишет это "<что-то>" в командной строке), так что может 
методически лучше дать самый типичный и притом работающий пример.

Я НЕ имею в виду, что в таком справочнике должны быть _только_
описанные конструкции, просто списки команд тоже скорее всего нужны, 
но конструкции будут правильным довеском.

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

$ grep -v "^#"


-- 
Кирилл Маслинский
Альт Линукс
руководитель издательских проектов
http://heap.altlinux.ru