From owner-freebsd-doc@FreeBSD.ORG Mon Mar 18 17:30:52 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D617F1A3; Mon, 18 Mar 2013 17:30:52 +0000 (UTC) (envelope-from ike@blackskyresearch.net) Received: from rs149.luxsci.com (rs149.luxsci.com [64.49.224.181]) by mx1.freebsd.org (Postfix) with ESMTP id 9486EB6C; Mon, 18 Mar 2013 17:30:52 +0000 (UTC) Received: from rs149.luxsci.com (localhost.localdomain [127.0.0.1]) by rs149.luxsci.com (8.14.4/8.13.8) with ESMTP id r2IHUioG000619; Mon, 18 Mar 2013 13:30:45 -0400 Received: (from root@localhost) by rs149.luxsci.com (8.14.4/8.13.8/Submit) id r2IHU2IW031608; Mon, 18 Mar 2013 17:30:02 GMT Received: (from sender 74627) (rs149.luxsci.com [127.0.0.1]) by LuxSci SP; Mon, 18 Mar 2013 17:30:02 +0000 Subject: Re: Handbook Jail Chapter rewrite available for critique Content-Type: text/plain; charset=windows-1252 From: "Isaac (.ike) Levy" In-Reply-To: <51474796.1030808@a1poweruser.com> Date: Mon, 18 Mar 2013 13:29:18 -0400 Content-Transfer-Encoding: quoted-printable References: <51474796.1030808@a1poweruser.com> To: Fbsd8 X-Lux-Comment: Message r2IHTIkR030230 sent by user #74627 Message-Id: <1363627802-7836632.18463322.fr2IHTIkR030230@rs149.luxsci.com> X-Comment: LuxSci SP Message ID - 1363627802-7836632.18463322 Cc: freebsd-doc@freebsd.org, FreeBSD questions , freebsd-current X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 18 Mar 2013 17:30:52 -0000 Pretty heavy cross-posting here, could you perhaps reign this in to the = freebsd-jail@ list, where it can be discussed in-context? This will = help keep the noise down. On Mar 18, 2013, at 12:57 PM, Fbsd8 wrote: > To all interested parties; >=20 > I have completed the final draft of the total rewrite of FreeBSD's = handbook Chapter 16 on Jails. >=20 > Before submitting my work for submission to the documentation group = for insertion in the handbook I am looking for critique of the work to = find errors in concept, wrong use of words, or anything to make it = better. >=20 > All feedback welcomed. >=20 > Use this URL to access it http://www.jails.a1poweruser.com/ >=20 >=20 > Thank You. Wow, overall that's really quite cool. - Do you have a rough timeframe for when you want feedback? (I would = like to give this the time it deserves). -- Feedback right off the bat, (please tell me if I'm off track here): - After a short skim- I do not believe the qjail utilities referenced = are appropriate for the FreeBSD handbook. There are many 3rd party = approaches to handling/managing jails, some of them with quite long = histories and loyal user bases- it is impractical and not appropriate to = try to cover any/all of them here. - The "Jail Cell" vocabulary is a serious departure- and may create some = confusion- I'll read thoroughly to get your context right. In what I = understand to be the majority of uses, it's confusing to think of the = hardware host as the 'jail' and the jailed instance as the 'cell'. - The references and history cite some works, but do not cite the = original (and possibly most important) document on jailing, = http://docs.freebsd.org/44doc/papers/jail/jail.ps.gz - There are a number of common lexical errors right off the bat, (There = instead of Their), etc=85 -- I look foreword to reading this on my subway commute this week- Best, .ike