Re: Documentation and explanatory diagrams

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Steve Atkins <steve(at)blighty(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Documentation and explanatory diagrams
Date: 2010-07-17 14:27:03
Message-ID: 7984.1279376823@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Steve Atkins <steve(at)blighty(dot)com> writes:
> On Jul 16, 2010, at 7:20 PM, Robert Haas wrote:
>> Unless I'm misunderstanding what you're talking about here, this is a
>> really, really bad idea.

> You're misunderstanding.

Yeah, I think that in the main you guys are in violent agreement.

> My feeling is that SVG is a decent lowest common denominator.

I think this might be true in principle but not necessarily in
practice. For example, if two tools write out SVG with different
whitespace layout, that's going to kill diff-ing and VCS friendliness.
This could probably be worked around, eg by settling on some particular
tool as the one to run it through before committing (sort of a pgindent
for graphics). But we need to do some experimentation with specific
tools and see what the output really looks like and how it changes
given small changes in the diagram, before we choose anything.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2010-07-17 14:30:13 Re: Railroad diagrams, a-la sqlite
Previous Message Hannu Krosing 2010-07-17 07:12:31 Re: Railroad diagrams, a-la sqlite