Date: Thu, 16 Apr 2009 23:36:54 +0300 From: Manolis Kiagias <sonic2000gr@gmail.com> To: "freebsd-doc@freebsd.org" <freebsd-doc@freebsd.org> Cc: Chris Pepper <pepper@cbio.mskcc.org>, Tom Rhodes <trhodes@FreeBSD.org>, Gabor PALI <pgj@FreeBSD.org>, Giorgos Keramidas <keramida@freebsd.org>, Gabor Kovesdan <gabor@FreeBSD.org> Subject: [PATCH] for the 'firewalls' chapter Message-ID: <49E796E6.70709@gmail.com>
next in thread | raw e-mail | index | archive | help
Hey all, Once again, calling all my usual reviewers (as well as anyone else who wishes to comment) on this (unfortunately long) patch for the 'firewalls' chapter. I've been writing and rewriting this for quite some time now, partly while I was translating the chapter to Greek but also for quite some time afterwards. It has gone through many changes and also includes relevant parts from PR docs/131568 (author CCed). I will try to summarize some of the changes, although this is as huge a task as the patch itself! - Attempt to reduce some duplication. An identical paragraph on what is an inclusive firewall was removed from each section, rephrased and added at the beginning of the chapter. There are still more sections that contain duplicate information. - Convert to passive voice where possible and reduce amount of 'you' (and in some cases 'I') references - Rephrase several paragraphs (some were already commented as problematic in the source). There were cases were the information was clearly wrong (i.e. it was referenced that a packet exits the network, reaches the destination and returns. Clearly, this is not the same packet). Also not all firewalls need to have two interfaces (this was submitted in the above PR). - Attempt to improve markup. Originally I was planning to use <acronym>s everywhere, but the chapter is so full of them, that even the subtle dotted line HTML rendering becomes tiring after a while. I did insert <acronym>s for consistency, where some terms were already marked (i.e. TCP) and adjacent terms were not (i.e. UDP). If people feel we should markup all of them, I'll gladly do it. I also inserted/fixed numerous other tags (mostly <literal>) - Fix grammar / syntax / spelling in several cases - Numerous other changes that will hopefully become clear while reading the patch itself Here is the diff: http://people.freebsd.org/~manolis/firewalls.diff If you prefer to read the HTML build: http://www.freebsdgr.org/handbook-mine/firewalls.html Plase take all the time you need to read this - I will try to integrate any suggested changes as they are coming, and obviously this is not going in soon :) Thanks in advance, manolis@
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?49E796E6.70709>