Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1eq8nG-0000ff-JB for pgsql-docs@arkaria.postgresql.org; Mon, 26 Feb 2018 02:45:34 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1eq8nF-0003MM-6r for pgsql-docs@arkaria.postgresql.org; Mon, 26 Feb 2018 02:45:33 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1eq8nE-0003M2-Ou for pgsql-docs@lists.postgresql.org; Mon, 26 Feb 2018 02:45:33 +0000 Received: from mail-ua0-x235.google.com ([2607:f8b0:400c:c08::235]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1eq8mv-0001UH-KF for pgsql-docs@lists.postgresql.org; Mon, 26 Feb 2018 02:45:31 +0000 Received: by mail-ua0-x235.google.com with SMTP id e25so1072704uam.6 for ; Sun, 25 Feb 2018 18:45:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=2ndquadrant-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=wTDhbaFpvNKjV4qgoDx1uF59EfSvqOMiI6ah6vm8YeY=; b=manMkyqEbGSH5B+3dJD+lg18TjP0GJ+wmTBmKaJkiqjnJ1jhg8H1EfaXNp9pRcf9r9 oXpTAWXjrJKtL2j19BszvuEEUZINzn6sbJPL715XF/LCXk3dHkz5T7h0jzC+RYkl4vLU ffD9xhjLtC3/gLTfuhM8tyodStRCJkVuqb9TDOwK5Og1GjoCWf7JY25qqlF7H/O3wB0f RMInREVj5gJVMQW+vbe7IHz48ItDVNBZrvevNaepf+YxVFnhqi/bR7ZFe0rOgf3nhdjG rZDjQY3j3ifKU3QpanI6RXxqM0m3qGjuMS8cMYpfO+YGBcF0LztD9LzVNxJxcT1PmWYJ TTug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=wTDhbaFpvNKjV4qgoDx1uF59EfSvqOMiI6ah6vm8YeY=; b=nVGDsP0kwp0nnXSFwChf+ubLrnX8Xh8Q8XI9pe6DSfHN6EZPfq8Rlz2nGx1hjMkSUZ 56KE0l+9aTzU223iYwI8698Yvk8k5+rmWpieTxkRrUGdFODyU6gWSRg4sYCrHy11O8XH Kcn2TxjX0M4PSlm1elyM7Feb4s7r1bAKi4qkGSrCFTOGGqhI+WskAyVLuPAEUTHXRsEl rJfd7FLLXN5YZ1Uo0iuqkdt3GmExR5CeKRjNR4WAD76wbVR0kDEtSLhqFzXimcUxzLiv Q8ZCOqbDsp3dqCznl4gblR3TApz6QJLQ2QBCO6U/HtNha9Deu+DJS3h9M31Ix/nnS03R 5PeQ== X-Gm-Message-State: APf1xPDmoduE5Ktqv/kCA75ZU13qcYPyJPKEziEZ/nOu0zZ8ZR89NOLq +QdeV/ZkBo7mqkeK1LSPoTAMXaoMp/DLOoIEs/V+lQ== X-Google-Smtp-Source: AG47ELtslB6z3x9VGUxBJJ8nsColoweIzHgfocCg3IXiazMzThVg0Ram+ab/2zBwQ7VNoGDQaSswWJgsa5gLfwnK0vA= X-Received: by 10.159.49.27 with SMTP id m27mr7246424uab.169.1519613111270; Sun, 25 Feb 2018 18:45:11 -0800 (PST) MIME-Version: 1.0 Received: by 10.159.58.98 with HTTP; Sun, 25 Feb 2018 18:45:10 -0800 (PST) In-Reply-To: <08B83F11-EB17-4436-B73A-1857898B6B9B@blighty.com> References: <1914747379.117313.1519402446241.JavaMail.zimbra@dbi-services.com> <08B83F11-EB17-4436-B73A-1857898B6B9B@blighty.com> From: Craig Ringer Date: Mon, 26 Feb 2018 10:45:10 +0800 Message-ID: Subject: Re: Images in the official documentation To: Steve Atkins Cc: pgsql-docs@lists.postgresql.org Content-Type: multipart/alternative; boundary="f403045ddf74b199ec0566147fbe" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --f403045ddf74b199ec0566147fbe Content-Type: text/plain; charset="UTF-8" On 26 February 2018 at 04:12, Steve Atkins wrote: > > Writing SVG by hand maybe doesn't seem the best idea. > > I understand the attraction to people who want to store everything as > diffable text, but images of this sort are unlikely to get updated by > others, which means they're unlikely to be maintained as the things they're > intended to document change. It also means that the people best suited to > generating diagrams are the least likely to do so, and vice-versa. > > > Yeah, I think it'd just effectively preserve the status quo by rendering anyone who's willing to add images and designs to the docs unable - or unlikely to be willing - to do so. -- Craig Ringer http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Training & Services --f403045ddf74b199ec0566147fbe Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On 2= 6 February 2018 at 04:12, Steve Atkins <steve@blighty.com> w= rote:

Writing SVG by hand maybe doesn't seem the best idea.

I understand the attraction to people who want to store everything as diffa= ble text, but images of this sort are unlikely to get updated by others, wh= ich means they're unlikely to be maintained as the things they're i= ntended to document change. It also means that the people best suited to ge= nerating diagrams are the least likely to do so, and vice-versa.



Yeah, I think it'd just effect= ively preserve the status quo by rendering anyone who's willing to add = images and designs to the docs unable - or unlikely to be willing - to do s= o.=C2=A0



--
=C2=A0Craig Ringer=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0= =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 http://www.2ndQuadr= ant.com/
=C2=A0PostgreSQL Development, 24x7 Support, Training & = Services
--f403045ddf74b199ec0566147fbe--