From owner-freebsd-advocacy Sat Apr 3 14:27:15 1999 Delivered-To: freebsd-advocacy@freebsd.org Received: from smtp03.primenet.com (smtp03.primenet.com [206.165.6.133]) by hub.freebsd.org (Postfix) with ESMTP id 3D2AB14CAC for ; Sat, 3 Apr 1999 14:27:08 -0800 (PST) (envelope-from tlambert@usr04.primenet.com) Received: (from daemon@localhost) by smtp03.primenet.com (8.8.8/8.8.8) id PAA23266; Sat, 3 Apr 1999 15:25:13 -0700 (MST) Received: from usr04.primenet.com(206.165.6.204) via SMTP by smtp03.primenet.com, id smtpd023250; Sat Apr 3 15:25:12 1999 Received: (from tlambert@localhost) by usr04.primenet.com (8.8.5/8.8.5) id PAA13716; Sat, 3 Apr 1999 15:25:11 -0700 (MST) From: Terry Lambert Message-Id: <199904032225.PAA13716@usr04.primenet.com> Subject: Re: The FreeBSD Installation Guide Project [Was: Re: FreeBSD Adovcacy] To: grog@lemis.com (Greg Lehey) Date: Sat, 3 Apr 1999 22:25:11 +0000 (GMT) Cc: dpilgrim@uswest.net, dwilde1@thuntek.net, freebsd-advocacy@FreeBSD.ORG In-Reply-To: <19990403191536.G2142@lemis.com> from "Greg Lehey" at Apr 3, 99 07:15:36 pm X-Mailer: ELM [version 2.4 PL25] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-advocacy@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG > Hmm. I've just finished sending you a message on the discussion in > -newbies. I could almost use the same text again. The ideas are > good, but they don't fit into the existing framework. Nobody's > complaining about your willingness to help, but the best way to help > is to join in in the ongoing efforts, not reinventing the wheel. This reminds me of a statement an engineering VP made in a former company that: "We need everybody rowing in the same direction". Of course, with engineers in the room, somone (not me) piped up: "Yeah, but it's the _wrong_ direction". Just an anecdote. > > Maybe this is a rant and maybe it's the result of not knowing all > > that I should. But this *is* what I see and this *is* what I > > believe. > > You're relatively new in the FreeBSD fold. That doesn't mean that > you're not welcome, or that your ideas are not. But remember that we > have a number of structures in place. They're not all good, and with > good reason we will change them. But we need a good reason. What I > said was that I don't see a good reason. And don't overestimate my > importance, either. People can (and often do) shoot me down as well. > My statement was intended to be understood as "why not do it this > way?". I think relative newness is a job requirement for what he proposes to do. I also think that it doesn't undermine the work you've done (not that I seriously believe that you believe that, BTW), or the handbook. Finally, it can't hurt to have a lot of resources pop up when you ask a searh engine about FreeBSD. As long as the information is accurate, the more the better. People learn by metaphor. They are inherently visual, tactile, audiory, or spatial. I think until there are installation guides in each of these metaphors ("look at this", "listen to this", "type this", "think of this"), there's room for more installation guides. And if it turns out that we need 30 of them to cover the four bases, then we should look at this as an application of a genetic algorithm in the real world. > Consider what happens if you do it your own way, rather than putting > it in the handbook: we'll end up with two different installation > guides (well, three if you include mine, but that one costs money :-), > one undoubtedly better than the other, with contradictions in them > which will just confuse people. Put the best one at the top of the "links" list for the "installing FreeBSD" section of the FreeBSD web site. 8-). Better is relative, of course. See above. People will use whichever one "grabs" them. > If instead you take it upon yourself > (with help, possibly) to rewrite (or replace) the installation guide > in the handbook, you'll be doing everybody a service. The difference > between the two approaches is in small details: do you write it as a > standalone document, or as one which will fit in the handbook? Of > course, if you write it so it will work either way, so much the > better. Fitting it into the handbook has plusses and minuses. The big minus is that, with "The One True Bible" approach, you cover the topic only a single way, when multiple ways might really be a requirement. Terry Lambert terry@lambert.org --- Any opinions in this posting are my own and not those of my present or previous employers. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-advocacy" in the body of the message