From owner-freebsd-doc Mon May 14 10:32:17 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 1A6C537B422 for ; Mon, 14 May 2001 10:32:12 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f4EHMC924737; Mon, 14 May 2001 18:22:12 +0100 (BST) (envelope-from nik) Date: Mon, 14 May 2001 18:21:56 +0100 From: Nik Clayton To: Doug Young Cc: Sue Blake , freebsd-docs@FreeBSD.ORG, Rahul Siddharthan , Kathy Quinlan , N6REJ Subject: Re: (was) I'm leaving, now something like "anti official docs rant" :) Message-ID: <20010514182156.A22370@catkin.nothing-going-on.org> References: <002b01c0db54$e0febaa0$5599ca3f@disappointment> <20010513171444.E26123@welearn.com.au> <00f401c0db7e$ff3ca2a0$fe00a8c0@kat.lan> <20010513122623.I97034@lpt.ens.fr> <20010514084709.A68348@welearn.com.au> <024b01c0dc05$b1314fc0$0300a8c0@oracle> <20010514103623.B68348@welearn.com.au> <004901c0dc6a$ef1d1ac0$0300a8c0@oracle> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="LQksG6bCIzRHxTLp" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <004901c0dc6a$ef1d1ac0$0300a8c0@oracle>; from dougy@gargoyle.apana.org.au on Mon, May 14, 2001 at 09:42:18PM +1000 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --LQksG6bCIzRHxTLp Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 14, 2001 at 09:42:18PM +1000, Doug Young wrote: > I'm quite prepared to provide my Pedantic FreeBSD material,=20 I'll need the source (presumably you're using LinuxDoc) and all the images. > I made a > comment earlier about the lack of any form of diagram / graphics / > screenshot. The following documents feature diagrams: http://www.freebsd.org/doc/en_US.ISO_8859-1/books/design-44bsd/index.ht= ml http://www.freebsd.org/doc/en_US.ISO_8859-1/books/corp-net-guide/index.= html When I remember to turn it on in the build, so will http://www.freebsd.org/doc/en_US.ISO_8859-1/articles/vm-design/index.ht= ml > Whilst it may be the case that nobody has thought to provide such (as > you infer), but that seems beyond belief to me ... surely every adult on = the > planet has heard about "a picture tells a thousand words". Some of us just don't have the artistic skills. If you would like to submit a picture or diagram to go with any of the documentation, please do so, preferably using send-pr. > Maybe I'm just cynical, but I have this feeling that there is an > unwritten > commandment "Thou shalt not allow things that make it straightforward > for newcomers". An example that comes to mind is the age old issue of > ppp configuration that causes untold headaches for 90% of converts > from other religions. That ppp_conf.sh shell script that fixes the > thing in > 20 seconds flat has been lurking around the place since before JC > played fullback for Jerusalem, but where is any mention of it found in > official docs ?? Surely if documentation is meant to show people how > to > do stuff its reasonable to expect something as significant as this to > rate a > mention ??=20 I've never heard of it before, for one, and=20 locate ppp_conf.sh doesn't turn it up. Details? > Well I did expect at least some response to my query about "what > videocards typically work properly all the time", but the deafening=20 > silence so far suggests that the issue is somewhat of a yawn for the=20 > regulars.=20 Or that it's better served by the asking the XFree86 people? [ F'rinstance -- personally, I'm using a Matrox Millennium II with XFree86 4.0.3. I've got no idea if this is a good or bad card, or even if I've configured it for the maximum amount of speed. But it does work. ] N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --LQksG6bCIzRHxTLp Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.5 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjsAFDMACgkQk6gHZCw343USDACfeekBIju6jL4EW1Lj/df+ORLA 76UAn2ST9IHwBpKphOk23uDm5QkIHt7M =6Voe -----END PGP SIGNATURE----- --LQksG6bCIzRHxTLp-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message