From owner-freebsd-doc Mon Oct 16 14:25:11 2000 Delivered-To: freebsd-doc@freebsd.org Received: from smtp.nwlink.com (smtp.nwlink.com [209.20.130.57]) by hub.freebsd.org (Postfix) with ESMTP id 40EA137B66C for ; Mon, 16 Oct 2000 14:25:08 -0700 (PDT) Received: from utah (jcwells@utah.nwlink.com [209.20.130.41]) by smtp.nwlink.com (8.9.3/8.9.1) with SMTP id OAA21422; Mon, 16 Oct 2000 14:25:05 -0700 (PDT) Date: Mon, 16 Oct 2000 14:38:22 -0700 (PDT) From: "Jason C. Wells" X-Sender: jcwells@utah Reply-To: "Jason C. Wells" To: Peter Brezny Cc: freebsd-doc@FreeBSD.ORG Subject: Re: How To's In-Reply-To: <001401c037ad$e24645e0$47010a0a@fire.sysadmininc.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, 16 Oct 2000, Peter Brezny wrote: > Why don't we have a how too link on the freebsd main page? Because we don't have Howtos, not in any official capacity. > I've not been able to find a single document that gives you the > bare bones of what you need to do to enable ipfw. I found it without much trouble. First I clicked "Handbook" on the home page. Then I clicked firewalls. http://www.freebsd.org/handbook/firewalls.html Hmmm, there is one small piece missing on this page to be complete and thorough. It could be that the author felt that starting ipfw at boot was better documented in the "boot" documentation. Ahhh, there it is: http://www.freebsd.org/handbook/boot-init.html It tells me to read /etc/defaults/rc.conf. You should be able to take it from there. I feel it would be better for the firewall doc to add a sentence about starting ipfw at boot. > Please consider putting together a HOW TO page and putting a link to it on > the main freebsd site under documentation. We need it. No. We don't. More aptly stated, we don't have documentation named "Howto", therefore we don't have a link. Documents called Howto do exist outside of the documentation project. I personally, would prefer to see those docs rolled into the official documentation. I am sure lots of people are working hard at just that sort of thing. At the root of it all, Howto is just a name for how the Linux world _doesn't_ do documentation. FreeBSD does have documentation. One simply needs to learn what we call it. Thank you, Jason C. Wells To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message