From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <av1046@comtv.ru>
Date: Sat, 2 Mar 2002 01:41:29 +0300
From: Mikhail Zabaluev <mhz@alt-linux.org>
To: devel <devel@altlinux.ru>
Message-ID: <20020301224129.GA2564@mhz.mikhail.zabaluev.name>
Mail-Followup-To: Mikhail Zabaluev <mhz@alt-linux.org>,
	devel <devel@altlinux.ru>
References: <20020301184826.16a3b037.vyt@vzljot.ru>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="cNdxnHkX5QqsyA0e"
Content-Disposition: inline
In-Reply-To: <20020301184826.16a3b037.vyt@vzljot.ru>
User-Agent: Mutt/1.3.27i
Subject: [devel] Re: docs creations
Sender: devel-admin@altlinux.ru
Errors-To: devel-admin@altlinux.ru
X-BeenThere: devel@altlinux.ru
X-Mailman-Version: 2.0
Precedence: bulk
Reply-To: devel@altlinux.ru
List-Help: <mailto:devel-request@altlinux.ru?subject=help>
List-Post: <mailto:devel@altlinux.ru>
List-Subscribe: <http://altlinux.ru/mailman/listinfo/devel>,
	<mailto:devel-request@altlinux.ru?subject=subscribe>
List-Id: <devel.altlinux.ru>
List-Unsubscribe: <http://altlinux.ru/mailman/listinfo/devel>,
	<mailto:devel-request@altlinux.ru?subject=unsubscribe>
List-Archive: <http://altlinux.ru/pipermail/devel/>
Archived-At: <http://lore.altlinux.org/devel/20020301224129.GA2564@mhz.mikhail.zabaluev.name/>
List-Archive: <http://lore.altlinux.org/devel/>
List-Post: <mailto:devel@altlinux.org>

--cNdxnHkX5QqsyA0e
Content-Type: text/plain; charset=koi8-r
Content-Disposition: inline
Content-Transfer-Encoding: 8bit

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.

--cNdxnHkX5QqsyA0e
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE8gAOZTKqCuNPJlLgRAptMAKCtVsL10eQywHSVwxBniGX+zQ2PwgCeMyi8
4cYmI87OkOKbelET5bi4oHo=
=erEp
-----END PGP SIGNATURE-----

--cNdxnHkX5QqsyA0e--