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
Views: Raw Message | Whole Thread | Download mbox | Resend email
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

Browse pgsql-docs by date

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