Date: Wed, 3 Dec 2003 14:25:45 -0600 From: "Travis McArthur" <travis@travisbsd.org> To: "Decker Wong-Godfrey" <decker@apollonian.net>, <doc@FreeBSD.org> Subject: Re: Documenting Jail Message-ID: <000501c3b9db$a1b8b900$c700000a@Petra> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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" >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?000501c3b9db$a1b8b900$c700000a>