pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Joe Conway <mail@joeconway.com>
To: Steven Winfield <Steven.Winfield@cantabcapital.com>
To: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Subject: Re: SET ROLE documentation not entirely correct
Date: Thu, 25 Apr 2019 13:08:28 -0400
Message-ID: <67c97dbc-9caf-aa7e-622a-e20b28b7e597@joeconway.com> (raw)
In-Reply-To: <E9FA92C2921F31408041863B74EE4C2001BD62EB76@CCPMAILDAG03.cantab.local>
References: <155603476764.1372.10888362840885095061@wrigleys.postgresql.org>
	<03796ce5-8366-cd32-0436-9981ffbeb993@joeconway.com>
	<E9FA92C2921F31408041863B74EE4C2001BD62E4D4@CCPMAILDAG03.cantab.local>
	<c7dfb7a9-f9d9-245c-1b8a-4d5c1cea6a00@joeconway.com>
	<E9FA92C2921F31408041863B74EE4C2001BD62EB76@CCPMAILDAG03.cantab.local>

On 4/25/19 12:39 PM, Steven Winfield wrote:
>> We *just* very recently added the ability to add images. Not sure I want
>> to attempt creating one for this, but perhaps after I write the patch
>> you could give it a go with an image to match your thoughts?
> 
> That's great. Is there a page somewhere with a styling guide - preferred
> RGB values, fonts, allowable bitmap and/or vector formats... that sort
> of thing?

There is a documentation style guide (of sorts) here:

  https://www.postgresql.org/docs/devel/docguide-style.html

But it has nothing from what I can see to say about images.

FWIW, I believe images need to be svg format, but I am not entirely sure
of that.

There is also nothing I could find quickly searching through the docs
which describes how to insert images into the documentation. There is
one image which can be used as an example though:

https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=doc/src/sgml/storage.sgml;hb=HEAD

Likely both of those omissions should be fixed...

Joe

-- 
Crunchy Data - http://crunchydata.com
PostgreSQL Support for Secure Enterprises
Consulting, Training, & Open Source Development

Attachments:

  [application/pgp-signature] signature.asc (832B, ../67c97dbc-9caf-aa7e-622a-e20b28b7e597@joeconway.com/2-signature.asc)
  download

view thread (23+ messages)  latest in thread

Message-ID: <67c97dbc-9caf-aa7e-622a-e20b28b7e597@joeconway.com>
Permalink:  ../67c97dbc-9caf-aa7e-622a-e20b28b7e597@joeconway.com/
Also on:    postgresql.org/message-id/67c97dbc-9caf-aa7e-622a-e20b28b7e597@joeconway.com

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: mail@joeconway.com, Steven.Winfield@cantabcapital.com, pgsql-docs@lists.postgresql.org
  Subject: Re: SET ROLE documentation not entirely correct
  In-Reply-To: <67c97dbc-9caf-aa7e-622a-e20b28b7e597@joeconway.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox