Re: blatantly a bug in the documentation

On Tue, 2008-11-25 at 08:23 -0500, Tom Lane wrote:
> "Dave Page" <dpage@pgadmin.org> writes:
> > I'm in favour of including it by default (at initdb), so it's there
> > for new users to play with on any fresh install - however, there is
> > only a point to that if all the documentation examples are based on
> > that database to allow copy-paste-play.
> 
> You would also have to assume that all the examples are non-destructive,
> and that no one ever extends an example in a destructive way.  This
> seems like a non-starter.  Better to provide the sample database in a
> form in which it can be easily dropped/reloaded.  I'm envisioning that
> there's a source file in $sharedir and we tell people
> 
>     createdb example
>     psql -f $sharedir/example.sql example

Sounds good.

Please could we do this in a way that allows the example database to be
localised. It will help beginners understand things better if we have
table and column names in the local language. One more thing to
translate maybe, but lets leave the door open for localisation.

-- Simon Riggs           www.2ndQuadrant.comPostgreSQL Training, Services and Support