Date: Tue, 6 Aug 2002 06:25:54 -0700 (PDT) From: Ross Lippert <ripper@eskimo.com> To: dan@langille.org Cc: jim@FreeBSD.org, dan@langille.org, anderson@centtech.com, blackend@FreeBSD.org, cjuniet@entreview.com, freebsd-doc@FreeBSD.org Subject: Re: docs/41106: FreeBSD Handbook lacks "Desktop Applications" chapter. Message-ID: <200208061325.GAA24902@eskimo.com> In-Reply-To: <3D4EB965.29692.13F81F2E@localhost> (dan@langille.org)
next in thread | previous in thread | raw e-mail | index | archive | help
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200208061325.GAA24902>