[devel] Re: docs creations

Mikhail Zabaluev =?iso-8859-1?q?mhz_=CE=C1_alt-linux=2Eorg?=
Сб Мар 2 01:41:29 MSK 2002


Hello Vyt,

On Fri, Mar 01, 2002 at 06:48:26PM +0300, Vyt wrote:
>
> Hello, All!
> 
> Было бы просто здорово, если бы кто-нибудь из корифеев разразился
> кратким введением на тему _правильного_ написания документации.
> Хотя бы в виде набора ссылок для начинающих...
> 
> Интересует формат, инструменты, необходимые пакеты из Sisyphus,
> приемы. 
> 
> Из имеющегося обилия сложно выбрать нужное, после ковыряния с
> postfix.xml от MhZ смотрю на http://www.docbook.org, чувствую,
> что это надолго :)

А чего тут долгого, после того как в дистрибутиве всё более-менее
налажено, можно просто пролистать Docbook: The Definitive Guide
и начать ваять документы, как сделал я.
По сложности примерно то же, что HTML (даже без таблиц), но по
"прямизне" и продуманности гораздо лучше.

-- 
Stay tuned,
  MhZ                                     JID: mookid на jabber.org
___________
Each person has the right to take the subway.
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 232 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/devel/attachments/20020302/c9b95bbd/attachment-0001.bin>


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