[devel] Re: docs creations

[Mikhail Zabaluev <mhz@alt-linux.org>]

[-- Attachment #1: Type: text/plain, Size: 916 bytes --]

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.

[-- Attachment #2: Type: application/pgp-signature, Size: 232 bytes --]