Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 16 Oct 2000 14:38:22 -0700 (PDT)
From:      "Jason C. Wells" <jcwells@nwlink.com>
To:        Peter Brezny <peter@sysadmin-inc.com>
Cc:        freebsd-doc@FreeBSD.ORG
Subject:   Re: How To's
Message-ID:  <Pine.SOL.3.96.1001016140814.4856A-100000@utah>
In-Reply-To: <001401c037ad$e24645e0$47010a0a@fire.sysadmininc.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.SOL.3.96.1001016140814.4856A-100000>