Regarding documentation (handbook) quality

Niclas Zeising niclas.zeising at gmail.com
Sat May 5 11:31:30 UTC 2007


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
-- 



More information about the freebsd-doc mailing list