[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