[docs] Re: docs plans

Alexandre Prokoudine avp на altlinux.ru
Пт Дек 26 16:06:45 MSK 2003


Anton V. Boyarshinov wrote
> > > 
> > > Первые 2 не интересно -- я знаю ответ. Третье -- элементарно:
> > > 
> > > apropos spaces 
> > 
> > А где оно описано в документации ???
> 
> Мораль -- должны быть описаны способы доступа к существующей
> электронной документации. С другой стороны -- man описан, стало
> быть и apropos в man man найти несложно.

Использование apropos у нас документировано прямо сейчас в

CVSDOCS/books/junior-2.3/quickstart/documentation/documentation.xml

Кроме того, apropos и whatis упоминаются во всех книжках, начиная с 
Master 2.0 (а то и раньше).

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

3. F.A.Q.


-- 
Alexandre Prokoudine		| "When you set yourself on fire and aim 
ALT Linux Documentation Team	|  for the sky, you hope to leave behind 
E-mail: avp на altlinux.ru		|  some sparks of heat and light"
JabberID: avp на altlinux.org	|                             Neil Peart
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031226/fecc44bb/attachment.bin


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