From owner-freebsd-doc@FreeBSD.ORG Wed Dec 3 12:07:54 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A789F16A4CE for ; Wed, 3 Dec 2003 12:07:54 -0800 (PST) Received: from starbuck.apollonian.net (starbuck.apollonian.net [67.40.4.205]) by mx1.FreeBSD.org (Postfix) with ESMTP id 91C2C43FF5 for ; Wed, 3 Dec 2003 12:07:52 -0800 (PST) (envelope-from decker@apollonian.net) Received: (qmail 92728 invoked by uid 85); 3 Dec 2003 20:12:49 -0000 Received: from decker@apollonian.net by starbuck.apollonian.net by uid 89 with qmail-scanner-1.16 tests=BAYES_00 autolearn=ham ):. Processed in 11.081391 secs); 03 Dec 2003 20:12:49 -0000 Received: from unknown (HELO ?192.168.0.12?) (decker@apollonian.net@67.40.4.201) by starbuck.apollonian.net with RC4-SHA encrypted SMTP; 3 Dec 2003 20:12:38 -0000 Mime-Version: 1.0 (Apple Message framework v606) In-Reply-To: <20031203183747.GA1326@electra.cse.Buffalo.EDU> References: <20031203124353.GD82966@droso.net> <20031203133557.GA23226@electra.cse.Buffalo.EDU> <20031203150958.GC72102@droso.net> <20031203183747.GA1326@electra.cse.Buffalo.EDU> Content-Type: text/plain; charset=US-ASCII; format=flowed Message-Id: <5C490C84-25CC-11D8-B8D9-0003934F6A0A@apollonian.net> Content-Transfer-Encoding: 7bit From: Decker Wong-Godfrey Date: Wed, 3 Dec 2003 12:07:45 -0800 To: doc@FreeBSD.org X-Mailer: Apple Mail (2.606) X-Spam-Checker-Version: SpamAssassin 2.60 (1.212-2003-09-23-exp) on starbuck.apollonian.net X-Spam-Status: No, hits=-4.9 required=5.0 tests=BAYES_00 autolearn=ham version=2.60 X-Spam-Level: Subject: Documenting Jail X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 03 Dec 2003 20:07:54 -0000 Hello all, I'd like to undertake writing more detailed Jail documentation. Personally, I have found the Jail manual page--while it is an excellent introduction to Jails--to be a little short on some information, for instance: * It still uses "make world" in its instructions for building the jail. Although this is probably the best solution for the manual page, there is nothing discussing the fact that "make world" is hardly necessary when a "make buildworld" (as is recommended by the handbook) for the host system will already leave everything needed in place. * It doesn't discuss using any of the make.conf args that can be used to define what the jail can and should have in it. * Although a Jail can run in the same IP address as the host, it only discusses setting up a jail on a different IP address than the host. Personally, I really like the Jail manual page because it does what I think a manual page should do: get to the nuts and bolts of getting things running. But outside the Jail manual page, I can't find any documentation, save a paper at http://docs.freebsd.org/44doc/papers/jail/jail.html (which concentrates more on what a Jail does than how to use a Jail). There seems to be plenty of need for something more, as I find plenty of (good and not so good) information that other people have put on their websites. The problem is, I'm not sure whether someone else is undertaking the same project. I've spent a couple months lurking around here, have looked at the FDP, but I'm still getting the hang of how things work. Maybe it's just because I'm used to documenting under different conditions; a little while back, I finished 3 years working as a systems administrator/technical writer for a company that worked writing documentation. There, everything was very formalized, people were assigned tasks & had deadlines. I understand that things work a little differently in a volunteer environment, but I'm still not quite sure how one would start a project (other than doing something like this). Anyways, thanks for all your hard work; believe me I've been very thankful on many occasions to all of you who have worked on the documentation. Decker Wong-Godfrey