X-Original-To: pgsql-www-postgresql.org@localhost.postgresql.org Received: from localhost (unknown [200.46.204.144]) by svr1.postgresql.org (Postfix) with ESMTP id D6CC55E4725 for ; Thu, 2 Sep 2004 20:56:53 -0300 (ADT) Received: from svr1.postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 03585-08 for ; Thu, 2 Sep 2004 23:56:51 +0000 (GMT) Received: from ganymede.hub.org (blk-222-46-91.eastlink.ca [24.222.46.91]) by svr1.postgresql.org (Postfix) with ESMTP id DC3045E4721 for ; Thu, 2 Sep 2004 20:56:49 -0300 (ADT) Received: by ganymede.hub.org (Postfix, from userid 1000) id B0CF138658; Thu, 2 Sep 2004 20:56:54 -0300 (ADT) Received: from localhost (localhost [127.0.0.1]) by ganymede.hub.org (Postfix) with ESMTP id A7B543859C; Thu, 2 Sep 2004 20:56:54 -0300 (ADT) Date: Thu, 2 Sep 2004 20:56:54 -0300 (ADT) From: "Marc G. Fournier" X-X-Sender: scrappy@ganymede.hub.org To: Tom Lane Cc: Devrim GUNDUZ , PostgreSQL WWW Mailing List Subject: Re: Comment forms in interactive docs In-Reply-To: <607.1094167125@sss.pgh.pa.us> Message-ID: <20040902205559.Q72978@ganymede.hub.org> References: <607.1094167125@sss.pgh.pa.us> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, hits=0.0 tagged_above=0.0 required=5.0 tests= X-Spam-Level: X-Archive-Number: 200409/15 X-Sequence-Number: 5085 On Thu, 2 Sep 2004, Tom Lane wrote: > Devrim GUNDUZ writes: >> There are comments forms interactive docs. I think we should remove them. >> Who follows the user comments in there? I'm sure, noone! > > Actually, we've made a practice of scavenging for useful comments at > least once a release cycle. There's a lot of crud in there, I agree, > but some good ideas about missing material too. Anyway, what is your > idea of "interactive" docs if not ones that people can comment on? I know that I tend to make extensive use of the user 'comments' when I'm looking at similar in the PHP docs ... you usually get some valuable examples that the docs are seriously lacking ... ---- Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: scrappy@hub.org Yahoo!: yscrappy ICQ: 7615664