Re: Adding a crucial element to an example - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Adding a crucial element to an example
Date
Msg-id 201008112122.o7BLMKT13539@momjian.us
Whole thread Raw
In response to Re: Adding a crucial element to an example  (John Gage <jsmgage@numericable.fr>)
List 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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

pgsql-docs by date:

Previous
From: Robert Haas
Date:
Subject: Re: ECPG - Some errno definitions don't match to the manual
Next
From: Thom Brown
Date:
Subject: Ambiguous index entry for Privileges