DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc:content-type:content-transfer-encoding;
	b=uHD+bWkSh+wxsYai9XRKOA9tSdzkwKCnbXPJO5Mjih+UhntAk6fWNty9DrN+HfjE2I
	gW20FXUuXmpaX5BkoLn93KsUi+CWJhzz7EaK62TFoR1CtB7P/skH02iAGFWf7UdDQ+qi
	ezHqffrxnhLazWQhxHmJZ08EpUCS1EqXMr1lQ=
MIME-Version: 1.0
In-Reply-To: <1279442215.30539.5.camel@vanquo.pezone.net>
References: <201007180446.o6I4kUG09416@momjian.us>
	<1279442215.30539.5.camel@vanquo.pezone.net>
From: Thom Brown <thombrown@gmail.com>
Date: Sun, 18 Jul 2010 10:56:57 +0100
Message-ID: <AANLkTinf4NneIgL4MhiWh_s-M4jTQlyncdN06vi3a60W@mail.gmail.com>
Subject: Re: Documentation and explanatory diagrams
To: Peter Eisentraut <peter_e@gmx.net>
Cc: Bruce Momjian <bruce@momjian.us>, Tom Lane <tgl@sss.pgh.pa.us>,
	Steve Atkins <steve@blighty.com>, pgsql-docs <pgsql-docs@postgresql.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On 18 July 2010 09:36, Peter Eisentraut <peter_e@gmx.net> wrote:
> On s=F6n, 2010-07-18 at 00:46 -0400, Bruce Momjian wrote:
>> Well, if we want _any_ images for the 9.0 docs, we had better decide
>> soon.
>
> I'd be very much against putting any images into 9.0 at this time. =A0I
> was working under the assumption that this discussion would be targeting
> 9.1.
>
>

+1

Considering that these will have to become a permanent fixture, I
don't expect this to be decided and working in time for 9.0.  I
assumed this was for 9.1 too.

There are too many unresolved concerns, and one I think is important
is whichever format is selected, can small changes be made to a
diagram using an editor without massive changes to the file.  Like Tom
said, we might have some editors which will behave and just alter a
piece of text we asked to be changed, and others decide it needs extra
markup and rearrange the order in which things are drawn etc.  And
should there be a whitelist of editors known to behave which people
are to use?

Thom