Re: Images in the official documentation - Mailing list pgsql-docs

From Jonathan S. Katz
Subject Re: Images in the official documentation
Date
Msg-id d1aa1550-3433-2c85-0f8b-979df551179f@postgresql.org
Whole thread Raw
In response to Re: Images in the official documentation  (Jürgen Purtz <juergen@purtz.de>)
List 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


Attachment

pgsql-docs by date:

Previous
From: Jürgen Purtz
Date:
Subject: Re: Images in the official documentation
Next
From: PG Doc comments form
Date:
Subject: Add NOTICE about non-NFC-characters and clues for solution