Skip site navigation (1) Skip section navigation (2)

Re: Adding a crucial element to an example

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: John Gage <jsmgage(at)numericable(dot)fr>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Adding a crucial element to an example
Date: 2010-08-11 21:22:20
Message-ID: 201008112122.o7BLMKT13539@momjian.us (view raw or flat)
Thread:
Lists: pgsql-docs
John Gage wrote:
> After the CREATE statement I would simply put:
> 
> INSERT INTO emp VALUES ('Bill', 4200, 45, '(2,1)');
> 
> What that accomplishes is making it so the user can simply copy and  
> paste the entire section and run it in pg_admin.  Then, the user can  
> start fiddling with it as he wants to.
> 
> I know this sounds terribly simple, but simplicity is good,  
> particularly when you're climbing a steep learning curve.  And there  
> is certainly, unequivocally, no harm in simplicity.

Our documentation got this good only through many small improvements
like this.  :-)

-- 
  Bruce Momjian  <bruce(at)momjian(dot)us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +

In response to

pgsql-docs by date

Next:From: Thom BrownDate: 2010-08-11 23:05:18
Subject: Ambiguous index entry for Privileges
Previous:From: Robert HaasDate: 2010-08-11 19:08:12
Subject: Re: ECPG - Some errno definitions don't match to the manual

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group