Re: Handbook Jail Chapter rewrite available for critique

Pretty heavy cross-posting here, could you perhaps reign this in to the fre=
ebsd-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;
> =

> I have completed the final draft of the total rewrite of FreeBSD's handbo=
ok Chapter 16 on Jails.
> =

> Before submitting my work for submission to the documentation group for i=
nsertion in the handbook I am looking for critique of the work to find erro=
rs in concept, wrong use of words, or anything to make it better.
> =

> All feedback welcomed.
> =

> Use this URL to access it  http://www.jails.a1poweruser.com/
> =

> =

> 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 a=
ppropriate for the FreeBSD handbook.  There are many 3rd party approaches t=
o 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 co=
nfusion- I'll read thoroughly to get your context right.  In what I underst=
and to be the majority of uses, it's confusing to think of the hardware hos=
t 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 ins=
tead of Their), etc=85

--
I look foreword to reading this on my subway commute this week-

Best,
..ike

_______________________________________________
freebsd-current@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-current
To unsubscribe, send any mail to "freebsd-current-unsubscribe@freebsd.org"