Re: House style for DocBook documentation?

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Chapman Flack <chap(at)anastigmatix(dot)net>
Cc: Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com>, Markus Winand <markus(dot)winand(at)winand(dot)at>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: House style for DocBook documentation?
Date: 2019-01-19 13:35:29
Message-ID: 201901191335.kbjzsoefmkoa@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-hackers


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
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to


Browse pgsql-hackers by date

  From Date Subject
Next Message Andrew Gierth 2019-01-19 14:06:08 Re: Ryu floating point output patch
Previous Message Amit Kapila 2019-01-19 13:05:49 Re: WIP: Avoid creation of the free space map for small tables