Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1kNGdX-0008KD-Ko
	for pgsql-docs@arkaria.postgresql.org; Tue, 29 Sep 2020 14:29:47 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1kNGdW-0003v4-IQ
	for pgsql-docs@arkaria.postgresql.org; Tue, 29 Sep 2020 14:29:46 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1kNGdW-0003ux-CU
	for pgsql-docs@lists.postgresql.org; Tue, 29 Sep 2020 14:29:46 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1kNGdU-0008CL-6i
	for pgsql-docs@lists.postgresql.org; Tue, 29 Sep 2020 14:29:45 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 08TETJWp609804;
	Tue, 29 Sep 2020 10:29:19 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Pavel Stehule <pavel.stehule@gmail.com>
cc: niels@thinkiq.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Version 13 documentation layout is harder to read than version 12
In-reply-to: 
 <CAFj8pRDHAX262QS=6X0wNDru1pWYQNFeDwXPnU0gex+b0cPfAg@mail.gmail.com>
References: <160135280918.659.8300614023795573502@wrigleys.postgresql.org>
 <608344.1601387551@sss.pgh.pa.us>
 <CAFj8pRDHAX262QS=6X0wNDru1pWYQNFeDwXPnU0gex+b0cPfAg@mail.gmail.com>
Comments: In-reply-to Pavel Stehule <pavel.stehule@gmail.com>
	message dated "Tue, 29 Sep 2020 16:01:59 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <609802.1601389759.1@sss.pgh.pa.us>
Date: Tue, 29 Sep 2020 10:29:19 -0400
Message-ID: <609803.1601389759@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk

Pavel Stehule <pavel.stehule@gmail.com> writes:
> the new layout is probably better, but I miss some gentle separation of
> these three parts - maybe using a different font?

Hm?  If you mean synopsis vs. description vs. examples, the description
already is a different font from the other two.

I recall that we did experiment with extra vertical whitespace to
separate, but abandoned that, possibly because controlling it was too
painful with DocBook.

			regards, tom lane