From owner-freebsd-doc Mon Apr 5 13:10:47 1999 Delivered-To: freebsd-doc@freebsd.org Received: from ptldpop1.ptld.uswest.net (ptldpop1.ptld.uswest.net [198.36.160.1]) by hub.freebsd.org (Postfix) with SMTP id 63F1215046 for ; Mon, 5 Apr 1999 13:10:43 -0700 (PDT) (envelope-from dpilgrim@uswest.net) Received: (qmail 24906 invoked by alias); 5 Apr 1999 20:08:43 -0000 Delivered-To: fixup-doc@FreeBSD.org@fixme Received: (qmail 24773 invoked by uid 0); 5 Apr 1999 20:08:36 -0000 Received: from fdsl89.ptld.uswest.net (HELO uswest.net) (216.161.80.89) by ptldpop1.ptld.uswest.net with SMTP; 5 Apr 1999 20:08:36 -0000 Message-ID: <3709180D.A8794E5A@uswest.net> Date: Mon, 05 Apr 1999 13:07:41 -0700 From: Darren Pilgrim Organization: Neatly stacked heaps of digital chaos X-Mailer: Mozilla 4.51 [en] (Win98; U) X-Accept-Language: en MIME-Version: 1.0 To: Greg Lehey Cc: junkmale@xtra.co.nz, Bill Fumerola , Donald Wilde , FreeBSD Documenters , freebsd-advocacy@FreeBSD.org Subject: Re: The FreeBSD Installation Guide Project [Was: Re: FreeBSD Adovcacy] References: <19990403191536.G2142@lemis.com> <19990404005224.CUBP5707006.mta2-rme@wocker> <3706CA33.986B5C15@uswest.net> <19990405115047.Q2142@lemis.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Greg Lehey wrote: > > I'm going to see to it that the IGP goes through to compile a > > no-assumptions guide. I've had a very long think about the Handbook > > and incorporating the IGP with it and come to the conclusion that > > while parts of the IGP probably could fit very well with the > > Handbook, rewriting the Handbook is just not what I want to do. > > I find this sad. You'd get a lot more help and cooperation if you'd > do it in the existing framework. If you go it alone, well, you go it > alone. The original object was to create a printed booklet that could be included with the CD set, so folks wouldn't have to flip flop between systems or screens to get through the install. I just thought that making something seperate from the Handbook, then incorporating it later would be easier than writing a large set of patches. Given that there is almost no part of the Handbook that doesn't make assumptions that would be a very large patchwork indeed. If it's the only way I can get help, then I'm willing to redirect my efforts to the Handbook. > Despite what Bill says, I think you should be. There are lots of > different styles in the handbook; putting in the IGP would be an > enrichment. As I said earlier, that doesn't mean that it should not > be possible to extract the IGP as a standalone document. Why not do it the other way around? > > I plan on soliciting for volunteers in -newbies. I just want to have > > some kind of a webpage up for them to read before waving the Uncle > > Sam posters. > > It seems fashionable at the moment to believe that newbies can do > things that experienced people can't, simply because they're closer to > the problem. I have yet to see a really successful document come out > of this approach. I've found it a lot easier to let experienced > people write the documentation and have newbies review it to death. The volunteers I was referring to are folks to do just that. I know I'm going to need experienced folks. -- dpilgrim@uswest.net /\ / __ Our lies are merely the gryph@mindless.com / \/OC/URNE truth of another world ICQ: 29880099 Death is not a kill -9, just a DALnet: anim0s make world and shutdown -r now PGPKey available To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message