From owner-freebsd-doc Sat Oct 3 17:11:45 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id RAA25262 for freebsd-doc-outgoing; Sat, 3 Oct 1998 17:11:45 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from vedanix.welearn.com.au (vedanix.welearn.com.au [203.35.200.140]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id RAA25241; Sat, 3 Oct 1998 17:11:32 -0700 (PDT) (envelope-from sue@vedanix.welearn.com.au) Received: (from sue@localhost) by vedanix.welearn.com.au (8.8.8/8.8.8) id KAA06148; Sun, 4 Oct 1998 10:14:39 +1000 (EST) (envelope-from sue) Message-ID: <19981004101438.39085@welearn.com.au> Date: Sun, 4 Oct 1998 10:14:38 +1000 From: Sue Blake To: Eivind Eklund , Greg Lehey , Ray Seals , Freebsd-Advocacy Cc: FreeBSD-doc@FreeBSD.ORG Subject: Re: On-line Help Mail-Followup-To: Eivind Eklund , Greg Lehey , Ray Seals , Freebsd-Advocacy , FreeBSD-doc@FreeBSD.ORG References: <000d01bdec7e$b9fde2e0$1a1e10ac@rseals.midwestis.com> <19981001114527.E603@freebie.lemis.com> <19981002125251.54527@follo.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89i In-Reply-To: <19981002125251.54527@follo.net>; from Eivind Eklund on Fri, Oct 02, 1998 at 12:52:52PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Oct 02, 1998 at 12:52:52PM +0200, Eivind Eklund wrote: > > Perhaps we technically should do the conversions as this - directly as > FreeBSD ports, where people can just install them (and thus get them > in /usr/local/share/doc/HOWTO/ or somesuch). That way, there is at > least a structure in place for keeping them up to date - and there is > precedence for pure documentation port (e.g, the Emacs Lisp manual). Yes, structure is more important than many realise. The success of the Linux HOWTO project seems to be due to three things that I can see: 1 Many users with a large amount of boypower 2 A tight, well known structure and image 3 Attitudes in the Linux community that motivate quality and quantity, these attitudes being created by the structure. We can't afford to look at the desired outcome and stab straight at it. Put the right stuff underneath and it'll happen and continue to happen. Take a look at their HOWTO web site to see how they come across. Talk to Linux users about why they wrote a HOWTO. Look at what's required before a HOWTO will be accepted. Writing these things is both an automatic duty of Linuxhood and a high status privilege (if it is accepted), Some see it as a contest to become the famous writer of something nobody else has been able to cover. Compare that with the way we beg and cajole for documents. I don't claim to have all the answers for us, but I do know that it needs a lot of planning and new attitudes to make it a success. Any HOWTO project we set up will need to be worthy of respect itself, the kind of respect that rubs off, before volunteers will flock to it. Our support efforts are good and improving, and HOWTOs will help a lot there, but training is another story. I'd like to see the same planning and effort put into more tutorials. But people expect HOWTOs and they're easier to write. Eventually we'll need both, so we might as well start with the HOWTOs. On my list of round tuits is a document to help technical heads write FreeBSD tutorials, since it requires two mutually exclusive skill sets. If it ever gets that far, I'll be looking for helpers well up on the principles of adult education who don't necessarily know a lot about FreeBSD. Then we might have something indispensable for the suits and home users that no other OS has offered. Later still, an extension of this could be a full online competency based learning centre, employing the newfangled online learning toys that people pay huge sums for to crash under NT, but doing it all with FreeBSD freebies. Training is now seen as the major business cost associated with change, more important than the cost of software. Meanwhile home users run around looking for a foothold. We haven't even begun to take a serious look at the training needs. Twelve months from now its significance will suddenly become more apparent, when we have more to offer the office users. Whether it's all volunteer effort or I do something myself and make a quick buck doesn't matter too much. Sew up the training angle in any form and we'll make both NT and Linux look like intolerably expensive alternatives. -- Regards, -*Sue*- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message