Re: Documentation and explanatory diagrams

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, "Marc G(dot) Fournier" <scrappy(at)hub(dot)org>, Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Peter Eisentraut <peter_e(at)gmx(dot)net>, Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Documentation and explanatory diagrams
Date: 2010-07-03 02:16:17
Message-ID: 1325.1278123377@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Robert Haas <robertmhaas(at)gmail(dot)com> writes:
> Is it at all practical to ship the PNGs as well as the DIA files in
> CVS, and make rebuilding the PNGs from the DIAs a separate step?

Other than the bulky file sizes I see nothing wrong with that approach.
We have traditionally not required developers to have autoconf installed
unless they wanted to muck with the configure script, and this seems
more or less equivalent.

> Also, I think we need to review these images carefully before adding
> any of them into our docs.

Sure. These are proof of concept not ready-to-ship diagrams. What we
ought to be looking at is what the source representation is like and how
easy it is for people to adjust the diagrams.

regards, tom lane

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2010-07-03 02:16:58 Re: Documentation and explanatory diagrams
Previous Message Bruce Momjian 2010-07-03 02:15:58 Re: Documentation and explanatory diagrams