From owner-freebsd-stable Wed Mar 22 9: 1:48 2000 Delivered-To: freebsd-stable@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 79A8537B895; Wed, 22 Mar 2000 09:01:46 -0800 (PST) (envelope-from kris@FreeBSD.org) Received: from localhost (kris@localhost) by freefall.freebsd.org (8.9.3/8.9.2) with ESMTP id JAA41344; Wed, 22 Mar 2000 09:01:46 -0800 (PST) (envelope-from kris@FreeBSD.org) X-Authentication-Warning: freefall.freebsd.org: kris owned process doing -bs Date: Wed, 22 Mar 2000 09:01:46 -0800 (PST) From: Kris Kennaway To: David Murphy Cc: stable@FreeBSD.ORG Subject: How to actually make a difference (Re: dot-0 releases) In-Reply-To: <20000322165223.K48595@enigma.redbrick.dcu.ie> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-stable@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Wed, 22 Mar 2000, David Murphy wrote: > The documentation should, of course, aim to teach everyone, but I > suggest an intermediate target to aim for: teaching the experienced, > skilful systems administrator unfamiliar with FreeBSD about FreeBSD's > particular quirks. > > It would also greatly help if the people who write the manuals > [Handbook, Release Notes and Release Announcements] and the people who > make pronouncements on mailing lists such as these synced up a little. With all the wastage of words on this topic, you (and others) could have written the simple patches to the documentation which clarify the "upgrading from source" issues and any others you may have. The doc committers don't have some god-given mandate on system documentation, you know. The first draft might not be acceptable to everyone, but it would be a start, and it would be a hell of a lot more constructive than just saying "something should be done to improve the documentation, by god". If you don't understand SGML, write in plain text and someone will be happy to mark it up for you once it's written. Kris ---- In God we Trust -- all others must submit an X.509 certificate. -- Charles Forsythe To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message