Re: Images in the official documentation

From: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
Cc: Craig Ringer <craig(at)2ndquadrant(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Steve Atkins <steve(at)blighty(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Images in the official documentation
Date: 2018-02-27 15:19:14
Message-ID: 20180227151914.2xtoygrwlm357fqo@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Peter Eisentraut wrote:
> 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.

... particularly so if said idea involves PHP, Haskell, Go, Python, or
any other language that we don't currently have as requirement in our
build chain.

GraphViz gets my vote, too. It may not produce the most elegant
diagrams in the universe, but the source format is as good as we can
get.

--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alexey Kuleshevich 2018-02-28 08:37:52 Re: GRANT and REVOKE grammar.
Previous Message Peter Eisentraut 2018-02-27 15:13:42 Re: Images in the official documentation