Date: Mon, 3 Aug 2015 15:37:29 -0300
From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Kevin Grittner <kgrittn@ymail.com>
Cc: Dmitry Igrishin <dmitigr@gmail.com>,
 pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Confused by example in 13.2.2
Message-ID: <20150803183729.GM2441@postgresql.org>
References: 
 <CAAfz9KPij74qK9YrzRXrhWhvdeZ8nZMqzMSMC+bkWSU7aBapLA@mail.gmail.com>
 <127576699.373753.1438565750177.JavaMail.yahoo@mail.yahoo.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <127576699.373753.1438565750177.JavaMail.yahoo@mail.yahoo.com>
User-Agent: Mutt/1.5.23 (2014-03-12)
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

Kevin Grittner wrote:

> Hopefully the example from the Wiki makes it clear. There has been
> some discussion about whether to link to the Wiki or bring an
> example like that into the documentation; but we usually don't
> link to Wiki pages and the example is somewhat long to include
> in-line in the documentation. Any thoughts on the best solution to
> that?

Yeah, the problem is that the wiki page may evolve and make the
"hardcoded" reference nonsensical.  I think a rewording similar to what
Dmitry proposed downthread is good: it illustrates the concept without
need for any external material.

-- 
Álvaro Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs