From: Tom Lane <tgl@sss.pgh.pa.us>
To: Daniel Gustafsson <daniel@yesql.se>
cc: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>,
        =?utf-8?Q?J=C3=BCrgen_Purtz?= <juergen@purtz.de>,
        pgsql-docs@lists.postgresql.org
Subject: Re: TOC: List of Figures
In-reply-to: <D0B6D499-0B67-4225-A908-141681E6F5AA@yesql.se>
References: <e9e5faa4-e920-3253-f6bb-794109e228a1@purtz.de>
 <304820c6-2ef5-0fdd-4610-1a09b970d9ef@2ndquadrant.com>
 <30333.1562524678@sss.pgh.pa.us>
 <9c19b21a-cc58-9aed-7be5-f3311b98466f@purtz.de>
 <d6e5b04b-1861-0e53-d7db-9e4df3d23f18@2ndquadrant.com>
 <D0B6D499-0B67-4225-A908-141681E6F5AA@yesql.se>
Comments: In-reply-to Daniel Gustafsson <daniel@yesql.se>
	message dated "Mon, 08 Jul 2019 21:54:42 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <12975.1562616601.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Mon, 08 Jul 2019 16:10:01 -0400
Message-ID: <12976.1562616601@sss.pgh.pa.us>
Precedence: bulk

Daniel Gustafsson <daniel@yesql.se> writes:
>> On 8 Jul 2019, at 21:43, Peter Eisentraut <peter.eisentraut@2ndquadrant=
.com> wrote:
>> This would make sense if we had fifty images spread evenly throughout
>> the documentation, or moreover, we had an image for every topic.  Then
>> learning by just flipping through the images would be interesting.  But
>> we are not nearly there yet.  Promoting a list of images now would just
>> make those looking for that kind of learning sad.

> We regularly include scaffolding for things to come in Postgres, I don=E2=
=80=99t see
> this being much different.  It will have just a few images now, but by t=
he time
> v13 ships we are likely to have a longer list which increase the value o=
f this
> further.

I tend to agree with Peter's argument here --- let's wait till there's a
meaningful number of figures and then reconsider whether there's use in
a list of them.  It's not like it will be any harder to make that change
in a year or two than it is today.

			regards, tom lane