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

From Bruce Momjian
Subject Re: Documentation and explanatory diagrams
Date
Msg-id 201007180446.o6I4kUG09416@momjian.us
Whole thread Raw
In response to Re: Documentation and explanatory diagrams  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Documentation and explanatory diagrams  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
Tom Lane wrote:
> 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.

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

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Railroad diagrams, a-la sqlite
Next
From: Peter Eisentraut
Date:
Subject: Re: Documentation and explanatory diagrams