From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Chapman Flack <chap@anastigmatix.net>
Cc: Pavel Stehule <pavel.stehule@gmail.com>
Cc: Markus Winand <markus.winand@winand.at>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: House style for DocBook documentation?
Date: Sat, 19 Jan 2019 10:35:29 -0300
Message-ID: <201901191335.kbjzsoefmkoa@alvherre.pgsql> (raw)
In-Reply-To: <5C427B6C.7050301@anastigmatix.net>
Hi
On 2019-Jan-18, Chapman Flack wrote:
> Is there, somewhere, a written-up "house style" for what DocBook 4.2
> elements to use for which types of content in the manual?
>
> In func.sgml I'm seeing what looks like a variety of examples, and
> I'm not sure which ones to try to follow.
I don't think we do. I'd suggest to come up with something and then see
if it makes sense to patch the docs to apply it regularly.
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-hackers@postgresql.org
Cc: alvherre@2ndquadrant.com, chap@anastigmatix.net, pavel.stehule@gmail.com, markus.winand@winand.at, tgl@sss.pgh.pa.us
Subject: Re: House style for DocBook documentation?
In-Reply-To: <201901191335.kbjzsoefmkoa@alvherre.pgsql>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox