Re: Documentation and explanatory diagrams - Mailing list pgsql-docs

From Tom Lane
Subject Re: Documentation and explanatory diagrams
Date
Msg-id 7984.1279376823@sss.pgh.pa.us
Whole thread Raw
In response to Re: Documentation and explanatory diagrams  (Steve Atkins <steve@blighty.com>)
Responses Re: Documentation and explanatory diagrams  (Bruce Momjian <bruce@momjian.us>)
Re: Documentation and explanatory diagrams  (Rafael Martinez <r.m.guerrero@usit.uio.no>)
List pgsql-docs
Steve Atkins <steve@blighty.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

pgsql-docs by date:

Previous
From: Hannu Krosing
Date:
Subject: Re: Railroad diagrams, a-la sqlite
Next
From: Tom Lane
Date:
Subject: Re: Railroad diagrams, a-la sqlite