Re: Images in the official documentation

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Craig Ringer <craig(at)2ndquadrant(dot)com>
Cc: Steve Atkins <steve(at)blighty(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Images in the official documentation
Date: 2018-02-26 19:23:14
Message-ID: 323.1519672994@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Craig Ringer <craig(at)2ndquadrant(dot)com> writes:
> On 26 February 2018 at 12:16, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>> How can we resolve these issues?

> Question the assumptions and requirements. Why do we actually _need_
> diffable, mergeable images? Sure, it'd be *nice*, but what's the real world
> impact if we don't have it?

Well, I'll tell you exactly why I'm being sticky about this: we've been
down this road before. We used to have some figures in .gif format,
and one of the problems with them was they were too hard to update.
I don't buy the "they won't need updates" argument for a second, either.
For instance, I recall that one of the images we had was a diagram of
the system catalog cross-references, and it was constantly out of date
because of the difficulty of updating it.

Admittedly, this was 15+ years ago. Maybe the state of the art in
figure editors has advanced to the point where it won't be so hard.
But color me suspicious.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2018-02-26 22:42:45 Re: Extra indentation in first line
Previous Message David G. Johnston 2018-02-26 13:50:07 Re: Extra indentation in first line