[devel] Re: docs creations

[Vyt]

On Fri, 1 Mar 2002 20:17:31 +0300
Igor Homyakov <homyakov на ramax.spb.ru> wrote:

<skipped>

> > > Было бы просто здорово, если бы кто-нибудь из корифеев разразился
> > > кратким введением на тему _правильного_ написания документации.
> > > Хотя бы в виде набора ссылок для начинающих...
> > > 
> > > Интересует формат, инструменты, необходимые пакеты из Sisyphus,
> > > приемы. 
> > > 
> > > Из имеющегося обилия сложно выбрать нужное, после ковыряния с
> > > postfix.xml от MhZ смотрю на http://www.docbook.org, чувствую,
> > > что это надолго :)
> > > 
> > 
> > Можно, например, на texinfo.

Плохо выразился - нужно писать документацию не к исходным
текстам, скорее общая, например, к jabber ;)

> На мой взгляд docbook представляеться боллее правильным решением

Спасибо!

Нашел великолепную статью Бориса Тоботраса
http://xtalk.opensource.ru/SGML/SGML-article.html
Он меня не убедил, он меня выразил :)

Похоже, что форматом лучше взять sgml с docbook-dtds, если не
прав - поправьте, pls.

<skipped>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/devel/attachments/20020301/16093338/attachment-0001.bin>