Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1gkqmm-0000l6-22
	for pgsql-hackers@arkaria.postgresql.org; Sat, 19 Jan 2019 13:35:44 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.89)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1gkqmj-0005UW-DC
	for pgsql-hackers@arkaria.postgresql.org; Sat, 19 Jan 2019 13:35:41 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <alvherre@2ndquadrant.com>)
	id 1gkqmj-0005PX-08
	for pgsql-hackers@lists.postgresql.org; Sat, 19 Jan 2019 13:35:41 +0000
Received: from mail-qk1-x741.google.com ([2607:f8b0:4864:20::741])
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <alvherre@2ndquadrant.com>)
	id 1gkqmc-0007zj-Vu
	for pgsql-hackers@postgresql.org; Sat, 19 Jan 2019 13:35:40 +0000
Received: by mail-qk1-x741.google.com with SMTP id g125so9647804qke.4
        for <pgsql-hackers@postgresql.org>;
 Sat, 19 Jan 2019 05:35:34 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=2ndquadrant-com.20150623.gappssmtp.com; s=20150623;
        h=date:from:to:cc:subject:message-id:mime-version:content-disposition
         :content-transfer-encoding:in-reply-to:user-agent;
        bh=6D1CpxZDr34n5ThdUSsQXJ8K5R3+SZ3Vd2wRyO4jX00=;
        b=b96rU1++83GnL9HE7E0WZgGfTstlb2iLUBEg6z+DLSfwYU/QXv33U8Z22O19wx5swJ
         wkl+aXNQHVEe3vwu84FA6N+YMMNakjERcG3UqIIyczfHdDehHvRh4qIdE9F7nVjZUs8I
         660092iJl1oBAUTeEvdXHIoEmEiza6LKdODmZi5UYnV5zmR2J0/RiQWajByuoRsDv+vC
         cnwbfaZW2VEyVSGtjhZ5kLuJFg0kPzv3n7aNR6xnAaFYD5WfwvxZLBcGJywuNLCqmTBl
         hK4JBevPrEMcWxa5WhwqMC4pY1l9+5iJmWd1p1m/IcZDxCw9csjdAwzndsRURwKodGoT
         6xHw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20161025;
        h=x-gm-message-state:date:from:to:cc:subject:message-id:mime-version
         :content-disposition:content-transfer-encoding:in-reply-to
         :user-agent;
        bh=6D1CpxZDr34n5ThdUSsQXJ8K5R3+SZ3Vd2wRyO4jX00=;
        b=abCy+n/YSkrfHUezWakpiJcCWWjSZvSlymzxjblNMfdzeSZNYERppxLCzYO73oMvNi
         SZKNkXP9Rpos6Xu57uKkX8hD6VZH01TMepCOXj48x/MOyj/PzhFdmdxbgW98bY/1djHn
         LPFcF/UJMBR3avLRKgdSRONbT69l7njQMqxoqY537yJrzcIdrheKNA1NOwarJmop8Yl0
         WA7pCpvmlGJ4HDhKNTHWUfF7J+bzpDtEjOsjZNuFHEy4BVBL6G31c8bXX6kTQI5iGPoK
         aisPAQaSCG9OJbd9tQvTcR26DmMMaAOIs8Tzori5ax7FbjjwPTzLN2RHJkjyYZaaNgdo
         47lw==
X-Gm-Message-State: AJcUukcD9U/dtcOP69odcudG7n8VR/a5wuavb84Ywt0qHiDte9BKCfcG
	y/nKj9ru/L5E7JMkBVHgTx6kNQ==
X-Google-Smtp-Source: 
 ALg8bN6+iBWpRRCAfUrsdgqXBk8YNvthLRcft81F3X3hM/BF8D2a/CKqN/aPkU5Mhcyr4X058UyBqQ==
X-Received: by 2002:a37:6b42:: with SMTP id
 g63mr18225970qkc.297.1547904932955;
        Sat, 19 Jan 2019 05:35:32 -0800 (PST)
Received: from alvin.alvh.no-ip.org ([201.186.80.67])
        by smtp.gmail.com with ESMTPSA id
 u4sm42363982qkk.51.2019.01.19.05.35.31
        (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
        Sat, 19 Jan 2019 05:35:32 -0800 (PST)
Received: by alvin.alvh.no-ip.org (Postfix, from userid 1000)
	id DE249876; Sat, 19 Jan 2019 10:35:29 -0300 (-03)
Date: Sat, 19 Jan 2019 10:35:29 -0300
From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Chapman Flack <chap@anastigmatix.net>
Cc: Pavel Stehule <pavel.stehule@gmail.com>,
	Markus Winand <markus.winand@winand.at>,
	Tom Lane <tgl@sss.pgh.pa.us>,
	PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: House style for DocBook documentation?
Message-ID: <201901191335.kbjzsoefmkoa@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <5C427B6C.7050301@anastigmatix.net>
User-Agent: NeoMutt/20180716-1013-2c1e88
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Precedence: bulk

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