Re: TOC: List of Figures

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, Jürgen Purtz <juergen(at)purtz(dot)de>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: TOC: List of Figures
Date: 2019-07-08 20:10:01
Message-ID: 12976.1562616601@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Daniel Gustafsson <daniel(at)yesql(dot)se> writes:
>> On 8 Jul 2019, at 21:43, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)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’t see
> this being much different. It will have just a few images now, but by the time
> v13 ships we are likely to have a longer list which increase the value of 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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Gustafsson 2019-07-08 20:21:20 Re: TOC: List of Figures
Previous Message Daniel Gustafsson 2019-07-08 19:54:42 Re: TOC: List of Figures