From owner-freebsd-doc@FreeBSD.ORG Sat May 5 10:09:24 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 0D4A916A402 for ; Sat, 5 May 2007 10:09:24 +0000 (UTC) (envelope-from kdulep@gmail.com) Received: from nz-out-0506.google.com (nz-out-0506.google.com [64.233.162.225]) by mx1.freebsd.org (Postfix) with ESMTP id C644313C45A for ; Sat, 5 May 2007 10:09:23 +0000 (UTC) (envelope-from kdulep@gmail.com) Received: by nz-out-0506.google.com with SMTP id s1so1147019nze for ; Sat, 05 May 2007 03:09:23 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition; b=lPlXsxd4P74OvBqdv7+pZCtiwUEJ1z9SCXJcW7UIQI2ZA7RTXEyHG946VDM5SlyaTv8UZKW0RSgaPw7WHA3u9vIxovqGrnpZ1Ut7oS7yKhuctUIzMFO6BWt7SLF+tQ+qXA7IHOUIHigxMKZVQyn5zwYMwqwx2aPuDx6IpTY8Xzs= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition; b=HTWuKFLejcIrN8FaHDvcPfhKPVuKjC1I/+a3v28FpofRZPC+N5Qzb1LTkYeE8XEWJMnv2guOc1nKasrjPREq2Tzo7HpmebRqOA0hX5Vn7wozXb5YHU5MM6YO4r84MvB/emr4eohUmIROb8aA9u3C5iIiCOfzKo0SRqnFAzau3C0= Received: by 10.114.92.2 with SMTP id p2mr583944wab.1178358127723; Sat, 05 May 2007 02:42:07 -0700 (PDT) Received: by 10.114.95.2 with HTTP; Sat, 5 May 2007 02:42:07 -0700 (PDT) Message-ID: <21ac428c0705050242pb32330fxbf247fa026337e03@mail.gmail.com> Date: Sat, 5 May 2007 10:42:07 +0100 From: "Konstantin Doulepov" To: doc@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline Cc: Subject: 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 10:09:24 -0000 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 --- All The Best Of All