Date: Mon, 14 May 2001 18:21:56 +0100 From: Nik Clayton <nik@freebsd.org> To: Doug Young <dougy@gargoyle.apana.org.au> Cc: Sue Blake <sue@welearn.com.au>, freebsd-docs@FreeBSD.ORG, Rahul Siddharthan <rsidd@physics.iisc.ernet.in>, Kathy Quinlan <katinka@magestower.com>, N6REJ <n6rej@tcsn.net> Subject: Re: (was) I'm leaving, now something like "anti official docs rant" :) Message-ID: <20010514182156.A22370@catkin.nothing-going-on.org> In-Reply-To: <004901c0dc6a$ef1d1ac0$0300a8c0@oracle>; from dougy@gargoyle.apana.org.au on Mon, May 14, 2001 at 09:42:18PM %2B1000 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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
On Mon, May 14, 2001 at 09:42:18PM +1000, Doug Young wrote:
> I'm quite prepared to provide my Pedantic FreeBSD material,
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.html
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.html
> 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 ??
I've never heard of it before, for one, and
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
> silence so far suggests that the issue is somewhat of a yawn for the
> regulars.
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
--
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 ---
[-- Attachment #2 --]
-----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-----
home |
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010514182156.A22370>