From owner-freebsd-doc Tue Aug 6 6:26: 0 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AA4B737B400; Tue, 6 Aug 2002 06:25:57 -0700 (PDT) Received: from mx1.eskimo.com (mx1.eskimo.com [204.122.16.48]) by mx1.FreeBSD.org (Postfix) with ESMTP id 19CEB43E4A; Tue, 6 Aug 2002 06:25:57 -0700 (PDT) (envelope-from ripper@eskimo.com) Received: from eskimo.com (ripper@eskimo.com [204.122.16.13]) by mx1.eskimo.com (8.9.1a/8.8.8) with ESMTP id GAA30040; Tue, 6 Aug 2002 06:25:54 -0700 Received: (from ripper@localhost) by eskimo.com (8.9.1a/8.9.1) id GAA24902; Tue, 6 Aug 2002 06:25:54 -0700 (PDT) Date: Tue, 6 Aug 2002 06:25:54 -0700 (PDT) Message-Id: <200208061325.GAA24902@eskimo.com> From: Ross Lippert To: dan@langille.org Cc: jim@FreeBSD.org, dan@langille.org, anderson@centtech.com, blackend@FreeBSD.org, cjuniet@entreview.com, freebsd-doc@FreeBSD.org In-reply-to: <3D4EB965.29692.13F81F2E@localhost> (dan@langille.org) Subject: Re: docs/41106: FreeBSD Handbook lacks "Desktop Applications" chapter. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Yes. It would be similar to what exists on the Diary >(http://www.freebsddiary.org/phorum/) and uses phorum code. I have to say that this thread has been very educational for me. There are areas of freebsddiary that I clearly should have been exploring already. >I have spent 10 minutes putting together a partially-functioning >prototype. See http://www.freshports.org/tmp/databases/postgresql7/ I think what we were thinking about should also include at least some sort of centralized document, perhaps linked to from that site. For example, someone might give a long document about postgressql7 talking about how they set theirs up, what they do with it and what features they get the most out of, and where they found tutorials to help them set it up. Something comprehensive like that which goes beyond the pkg-descr, and is more condensed and less fragmented than comments. Something postive and instructive with information about quick setup and examples and cool tricks which I have been calling a testimonial -- and not that every port should have one, just those which have one or more volunarily submitted (assuming moderation filters out those which are contentless or abusive etc). Additionally, let's suppose that someone wasn't sure how to meet their DB needs and wanted to browse all the entries in /usr/ports/databases, and see just which ones had such testimonials, which they could then read and get a pretty good idea what they'd be getting into if they installed that port. Maybe such a view would lead such a someone to try postgresql-tcltk, because they saw a few testimonials which really showed off that that port could do. I think comments are good, and they are needed, but the nature of a comment is to show 1 or two tricks, or gripe about a bug, or warn of something, or ask a question, and a tesimonial, in contrast is a big summary of tricks, work-arounds, warnings, and answers. -r To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message