Re: Documentation and explanatory diagrams

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Steve Atkins <steve(at)blighty(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Documentation and explanatory diagrams
Date: 2010-07-18 04:46:30
Message-ID: 201007180446.o6I4kUG09416@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Tom Lane wrote:
> 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.

Well, if we want _any_ images for the 9.0 docs, we had better decide
soon.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ None of us is going to be here forever. +

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2010-07-18 08:36:55 Re: Documentation and explanatory diagrams
Previous Message Tom Lane 2010-07-17 21:04:18 Re: Railroad diagrams, a-la sqlite