Re: Images in the official documentation

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: Jürgen Purtz <juergen(at)purtz(dot)de>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Images in the official documentation
Date: 2018-11-14 14:39:49
Message-ID: d1aa1550-3433-2c85-0f8b-979df551179f@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hi Jürgen,

On 11/14/18 8:36 AM, Jürgen Purtz wrote:
> After many mails, F2F-discussions and some experiments - everything
> without a concrete result - I hereby start a new initiative concerning
> SVG tools. The attached PDF file describes my recommendation. The two
> SVG files are examples for working in this sense.

It looks like you put a lot of effort into this, thanks! Those SVGs do
look great, and it's IMO it's a much needed feature to support images in
our documentation :) I will leave it to others to discuss if the
generated SVGs are a technical fit for the documentation code.

I would recommend that you transfer the contents of your proposal to the
PostgreSQL wiki (https://wiki.postgresql.org/) as it would make it
easier for others to collaborate on and contribute to it. If you need
help with it, please feel free to ping me.

The one thing that I see is if we would like to have a style guide,
primarily around colors, for images we put into the repo. I know that
somehow correlates with the definition of "bike shed" but it could also
help reduce that in the future. As we do have a PostgreSQL color
palette, I also see that as an opportunity to reduce potential
bikeshedding as well.

Thanks!

Jonathan

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2018-11-16 10:54:25 Add NOTICE about non-NFC-characters and clues for solution
Previous Message Jürgen Purtz 2018-11-14 13:36:09 Re: Images in the official documentation