Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 18 Mar 2013 13:29:18 -0400
From:      "Isaac (.ike) Levy" <ike@blackskyresearch.net>
To:        Fbsd8 <fbsd8@a1poweruser.com>
Cc:        freebsd-doc@freebsd.org, FreeBSD questions <questions@freebsd.org>, freebsd-current <freebsd-current@freebsd.org>
Subject:   Re: Handbook Jail Chapter rewrite available for critique
Message-ID:  <1363627802-7836632.18463322.fr2IHTIkR030230@rs149.luxsci.com>
In-Reply-To: <51474796.1030808@a1poweruser.com>
References:  <51474796.1030808@a1poweruser.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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





Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1363627802-7836632.18463322.fr2IHTIkR030230>