From: Vyt <vyt@vzljot.ru>
To: devel@altlinux.ru
Subject: [devel] Re: docs creations
Date: Fri, 1 Mar 2002 19:28:28 +0300
Message-ID: <20020301192828.26ba3c9c.vyt@vzljot.ru> (raw)
In-Reply-To: <20020301171731.GC20427@ramax.spb.ru>
[-- Attachment #1: Type: text/plain, Size: 1067 bytes --]
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
[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]
next prev parent reply other threads:[~2002-03-01 16:28 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2002-03-01 15:48 [devel] " Vyt
2002-03-01 16:10 ` Yura Zotov
2002-03-01 17:17 ` Igor Homyakov
2002-03-01 16:28 ` Vyt [this message]
2002-03-01 21:38 ` [devel] " Vitaly Lipatov
2002-03-02 6:58 ` Michael Shigorin
2002-03-02 8:12 ` Vitaly Lipatov
2002-03-02 11:30 ` Mikhail Zabaluev
2002-03-02 12:29 ` Vitaly Lipatov
2002-03-02 13:39 ` Mikhail Zabaluev
2002-03-02 17:54 ` Vitaly Lipatov
2002-03-02 22:50 ` Mikhail Zabaluev
2002-03-01 22:41 ` Mikhail Zabaluev
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20020301192828.26ba3c9c.vyt@vzljot.ru \
--to=vyt@vzljot.ru \
--cc=devel@altlinux.ru \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
ALT Linux Team development discussions
This inbox may be cloned and mirrored by anyone:
git clone --mirror http://lore.altlinux.org/devel/0 devel/git/0.git
# If you have public-inbox 1.1+ installed, you may
# initialize and index your mirror using the following commands:
public-inbox-init -V2 devel devel/ http://lore.altlinux.org/devel \
devel@altlinux.org devel@altlinux.ru devel@lists.altlinux.org devel@lists.altlinux.ru devel@linux.iplabs.ru mandrake-russian@linuxteam.iplabs.ru sisyphus@linuxteam.iplabs.ru
public-inbox-index devel
Example config snippet for mirrors.
Newsgroup available over NNTP:
nntp://lore.altlinux.org/org.altlinux.lists.devel
AGPL code for this site: git clone https://public-inbox.org/public-inbox.git