Date: Wed, 12 Jun 2002 08:53:07 +0100 From: Nik Clayton <nik@freebsd.org> To: Ross Lippert <ripper@eskimo.com> Cc: nik@FreeBSD.ORG, doc@FreeBSD.ORG Subject: Re: Per-release installation instructions? Message-ID: <20020612085307.B39690@canyon.nothing-going-on.org> In-Reply-To: <200206112109.OAA20191@eskimo.com>; from ripper@eskimo.com on Tue, Jun 11, 2002 at 02:09:04PM -0700 References: <20020611210023.A39690@canyon.nothing-going-on.org> <200206112109.OAA20191@eskimo.com>
next in thread | previous in thread | raw e-mail | index | archive | help
[-- Attachment #1 --]
On Tue, Jun 11, 2002 at 02:09:04PM -0700, Ross Lippert wrote:
> OR are you saying that by linking to the online installation notes
> that information post-4.5 was being mixed in with information current
> with 4.5? Was this because one was the online handbook and it should
> have been following a local link?
Yes.
Right now, go to the website. Look at the top right where it says
"Current Release: 4.5" (assuming 4.6 hasn't been released by the time
you read this.
The second link there is "Installation Guide" which goes to chapter 2 of
the Handbook on the web site.
The problem is that the handbook is now talking about 4-stable through
to 4.6. There's information in the install guide that's correct for
4-stable, but that is incorrect for 4.5.
For example, the version of X that's installed. There may be others.
We could work around this in the text:
... If you're installing FreeBSD 4.5 or lower then the X version
installed is 3.X. If you're installing FreeBSD 4.6 or above then
the X version installed is 4.X.
which is OK as far as it goes, but doesn't scale very well, and
distracts from the flow of the text.
Maybe repo copy chapter 2 to somewhere under the web tree at release
time and build it as a smaller book. We could do the same thing without
a repo copy because the Handbook's tagged with the release info, so the
web site build infrastructure could just check out a copy of the chapter
and its images with the correct tag.
Anyone feel like giving this a go?
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.7 (FreeBSD)
iD8DBQE9Bv3ik6gHZCw343URAhRoAJ0Xf2qUcCcCMVDvipAxBb2cXV91pwCeLAE5
1jPxiQ0C9TLIaa4rxnKMxqw=
=5ncj
-----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020612085307.B39690>