Received: from maia.hub.org (maia-2.hub.org [200.46.204.251]) by mail.postgresql.org (Postfix) with ESMTP id 53421632C5D for ; Wed, 11 Aug 2010 18:22:31 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia, port 10024) with ESMTP id 59635-03 for ; Wed, 11 Aug 2010 21:22:23 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from momjian.us (momjian.us [70.90.9.53]) by mail.postgresql.org (Postfix) with ESMTP id 0D37E632B4E for ; Wed, 11 Aug 2010 18:22:23 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id o7BLMKT13539; Wed, 11 Aug 2010 17:22:20 -0400 (EDT) From: Bruce Momjian Message-Id: <201008112122.o7BLMKT13539@momjian.us> Subject: Re: Adding a crucial element to an example In-Reply-To: To: John Gage Date: Wed, 11 Aug 2010 17:22:20 -0400 (EDT) CC: Peter Eisentraut , pgsql-docs@postgresql.org X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201008/21 X-Sequence-Number: 5845 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 http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. +