From owner-freebsd-doc@FreeBSD.ORG Sat May 5 11:31:30 2007 Return-Path: X-Original-To: doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 42C3A16A404 for ; Sat, 5 May 2007 11:31:30 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from pne-smtpout2-sn2.hy.skanova.net (pne-smtpout2-sn2.hy.skanova.net [81.228.8.164]) by mx1.freebsd.org (Postfix) with ESMTP id 08A8F13C484 for ; Sat, 5 May 2007 11:31:30 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from [213.64.217.2] (213.64.217.2) by pne-smtpout2-sn2.hy.skanova.net (7.2.075) id 46245DE1004A120C; Sat, 5 May 2007 12:22:20 +0200 Message-ID: <463C5AD2.9040609@gmail.com> Date: Sat, 05 May 2007 12:22:10 +0200 From: Niclas Zeising User-Agent: Thunderbird 2.0.0.0 (Windows/20070326) MIME-Version: 1.0 To: Konstantin Doulepov References: <21ac428c0705050242pb32330fxbf247fa026337e03@mail.gmail.com> In-Reply-To: <21ac428c0705050242pb32330fxbf247fa026337e03@mail.gmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@FreeBSD.org Subject: Re: Regarding documentation (handbook) quality X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 05 May 2007 11:31:30 -0000 Konstantin Doulepov wrote: > How documentation quality can be ensured in FreeBSD project? Why some > documentation chapters contain information of questionable quality. > Why handbook documentation is not quality of overall suite of > programs? Probably open questions... > > * PPP dial-in server, PPPoE, > * IPFW especially NAT sections -- there is no one example ruleset > that can be production quality and stable -- some functionality > mitigated due lack of properly placed rules. Given 2 examples of > identical duplicate ruleset. But no advanced real examples e.g. for > NAT and restrictive firewall rules both on OUTSIDE and INSIDE > NAT-enabled firewall > see good example at [http://www.lugbe.ch/lostfound/contrib/freebsd_router] > > Cheers, > > konstantin > --- The Handbook, as all other aspects of the FreeBSD project are written and contributed by people doing most of the work in their spare time. If you feel something is lacking in the operating system or in the documentation, feel free to write it and then contribute it to the project. Regards! //Niclas --