From owner-freebsd-doc@FreeBSD.ORG Wed Dec 3 12:23:47 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> 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 B622E16A4CE for <doc@FreeBSD.org>; Wed, 3 Dec 2003 12:23:47 -0800 (PST) Received: from succubus.travisbsd.org (rrcs-west-67-52-49-163.biz.rr.com [67.52.49.163]) by mx1.FreeBSD.org (Postfix) with ESMTP id 205B743F85 for <doc@FreeBSD.org>; Wed, 3 Dec 2003 12:23:46 -0800 (PST) (envelope-from travis@travisbsd.org) Received: from Petra (unknown [10.0.0.199]) by succubus.travisbsd.org (Postfix) with ESMTP id EBA1822859E; Wed, 3 Dec 2003 15:21:58 +0000 (GMT) Message-ID: <000501c3b9db$a1b8b900$c700000a@Petra> From: "Travis McArthur" <travis@travisbsd.org> To: "Decker Wong-Godfrey" <decker@apollonian.net>, <doc@FreeBSD.org> References: <20031203124353.GD82966@droso.net><20031203133557.GA23226@electra.cse.Buffalo.EDU><20031203150958.GC72102@droso.net><20031203183747.GA1326@electra.cse.Buffalo.EDU> <5C490C84-25CC-11D8-B8D9-0003934F6A0A@apollonian.net> Date: Wed, 3 Dec 2003 14:25:45 -0600 Organization: TravisBSD Network MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1158 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1165 Subject: Re: Documenting Jail X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Wed, 03 Dec 2003 20:23:47 -0000 Begin writting your documentation, and submit it here for review, when done follow the steps in the documentation project Submitting Documentation page for information on how to create a formal request to enter it into the system. -- Travis McArthur "Why, when I was your age...oh wait, I'm not your age yet. Sorry." ----- Original Message ----- From: "Decker Wong-Godfrey" <decker@apollonian.net> To: <doc@FreeBSD.org> Sent: Wednesday, December 03, 2003 2:07 PM Subject: Documenting Jail > 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 > > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" >