Date: Fri, 8 Sep 2000 16:11:06 -0700 From: Jim Mock <jim@lust.geekhouse.net> To: Andrew Boothman <andrew@cream.org> Cc: doc@FreeBSD.ORG Subject: Re: docs/20794: Request 2 good documents under people.freebsd.or Message-ID: <20000908161106.A545@envy.geekhouse.net> In-Reply-To: <XFMail.000908234240.andrew@cream.org>; from andrew@cream.org on Fri, Sep 08, 2000 at 11:42:40PM %2B0100 References: <20000908022043.C576@envy.geekhouse.net> <XFMail.000908234240.andrew@cream.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, 08 Sep 2000 at 23:42:40 +0100, Andrew Boothman wrote:
> On 08-Sep-00 Jim Mock wrote:
> >> Would you mind casting a critical eye over my markup when I'm done,
> >> I'm not 100% certain in what I'm doing yet.
> >
> > Sure, send 'em over.
>
> Thanks. My go at the second of the documents, the Filtering Bridges
> one, is attached. (That's also why I've only sent this message to the
> list, to save you having to download it twice)
>
> >> Out of interest, where could you see these documents fitting
> >> in? Handbook? Which section?
> >
> > Well, I think the one on PXE installs should definitely be in the
> > handbook in the installation chapter. The other one could probably
> > be made into an article of its own and put in the tutorials list.
>
> Oh, Whoops. Well I marked up 'the other one' like it was going to be
> added into the handbook. I guess it wouldn't take too much to turn
> into an article.
>
> Could someone just look over the markup to make sure I'm doing alright?
Looks ok, though there are some places where indentation is off. For
example:
> <chapter id="filtering-bridges">
> <title>Filtering bridges</title>
>
> <sect1 id="filtering-bridges-synopsis">
> <title>Synopsis</title>
>
> <para>For those of you who don't know, DSL differs from more traditional
> connectivity methods in that the "connectivity spigot" that comes
> out of the wall has no possibility for packet filtering. If you get
> a T1 line or some such it will come with a router that can generally
> include a packet filter. If you get ISDN or a dialup link, you also
> either have a software routing component (a PPP daemon, specifically)
> that can do some filtering or can be combined with a filter on the
> machine running the link. But with DSL you only get a little white
> box with some Blinkenlights on it and an Ethernet port that takes
> your traffic back and forth from the Internet and nothing else (to
> some extent the same can be said of other mass-market high speed
> connectivity methods, like cable modems or high speed wireless links
> as well. The same technique I plan to describe works just as well
> for them, or for any other technology that provides an Ethernet
> port with no filtering).</para>
> </sect1>
<chapter id="filtering-bridges">
<title>Filtering Bridges</title>
<para><emphasis>Contributed by foo, on XX Foo XXXX.</emphasis></para>
<sect1 id="filtering-bridges-synopsis">
<title>Synopsis</title>
<para>For those of you who don't know, DSL differs from more
traditional connectivity methods in that the "connectivity
spigot" that comes out of the wall has no possibility for packet
filtering. If you get a T1 line or some such it will come with a
router that can generally include a packet filter. If you get ISDN
or a dialup link, you also either have a software routing
component (a PPP daemon, specifically) that can do some filtering
or can be combined with a filter on the machine running the
link. But with DSL you only get a little white box with some
Blinkenlights on it and an Ethernet port that takes your traffic
back and forth from the Internet and nothing else (to some extent
the same can be said of other mass-market high speed connectivity
methods, like cable modems or high speed wireless links as
well. The same technique I plan to describe works just as well for
them, or for any other technology that provides an Ethernet port
with no filtering).</para>
</sect1>
Also, we (the Doc Project) use two spaces after a period. Other than
that, it looks ok to me.
- jim
--
jim mock <jim@jmock.com> work: jim@osd.bsdi.com | jim@FreeBSD.org
http://soupnazi.org/ BSDi Open Source Div | http://bsdi.com
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?20000908161106.A545>