Subject: Re: Images in the official documentation
To: Craig Ringer <craig@2ndquadrant.com>, Tom Lane <tgl@sss.pgh.pa.us>
References: <1914747379.117313.1519402446241.JavaMail.zimbra@dbi-services.com>
 <ff69cb83-9f90-4967-7de7-629bdfaa0c75@purtz.de>
 <08B83F11-EB17-4436-B73A-1857898B6B9B@blighty.com>
 <CAMsr+YEfh3qgxDeyAThi-nv0k3ptxhOZKW44kKzcaspGnWzC2A@mail.gmail.com>
 <22981.1519618609@sss.pgh.pa.us>
 <CAMsr+YGE8PU4THTTEXk4YkbfkZQrU32JJYojJzhQaKkZUKfXAQ@mail.gmail.com>
 <323.1519672994@sss.pgh.pa.us>
 <CAMsr+YG0uD2j9ZzSQJrRCNcDCsrWA4MG9Fns-bj3QWEr-8A5UQ@mail.gmail.com>
Cc: Steve Atkins <steve@blighty.com>, pgsql-docs@lists.postgresql.org
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <3f20469f-57b0-33cc-6bcc-e92316d52cbd@2ndquadrant.com>
Date: Tue, 27 Feb 2018 10:13:42 -0500
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:52.0)
 Gecko/20100101 Thunderbird/52.6.0
MIME-Version: 1.0
In-Reply-To: 
 <CAMsr+YG0uD2j9ZzSQJrRCNcDCsrWA4MG9Fns-bj3QWEr-8A5UQ@mail.gmail.com>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Precedence: bulk

On 2/26/18 20:02, Craig Ringer wrote:
> If I were maintaining the docs in a vacuum, I'd use graphviz for
> something like that, because it's a figure that does need regular
> updates and changes. And because
>  the list of fun things to do in my life definitely does not include
> hand-writing SVG. Not that tweaking GraphViz .dot is fun, but it's the
> default tool for a reason.
> 
> I'd be awfully tempted to generate the node-map part of the catalog
> relationship .dot file from a query, too.

I think graphviz would be a great fit for what we are discussing here.
Certainly more so then some-person-on-github's latest idea for how to
convert ASCII art into diagrams.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services