Skip site navigation (1)Skip section navigation (2)
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>