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
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 |