Regarding documentation (handbook) quality

Konstantin Doulepov kdulep at gmail.com
Sat May 5 10:09:24 UTC 2007


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



More information about the freebsd-doc mailing list