Date: Mon, 19 Jul 2004 12:28:31 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: Murray Stokely <murray@FreeBSD.org> Cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook Message-ID: <20040719102831.GA33180@eddie.nitro.dk> In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> References: <20040719100354.GA90972@hub.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--lrZ03NoBR/3+SXJZ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.19 10:03:54 +0000, Murray Stokely wrote: > I think the time has come to split up the Handbook. It has grown > unchecked for far too long and it has been several years since we last > moved chapters out of the Handbook (and into the Developers Handbook > in that case). Without having looked closely into which parts go where, I think it makes sense to do a split. > I can perform all of this work, ask for the repo copies, update all > cross links between chapters to use new entities to link between > volumes, and update the prefaces and frontmatter for both volumes. I > can do this in a single day so as to minimize disruption for others > working on the Handbook(s). I would suggest announcing the change a bit in advance and the doing a freeze for commits to the handbook during the change, to avoid making it more difficualt than necessary. > The preface and frontmatter of the > index.html at www.freebsd.org/handbook would contain a prominent > pointer to the new volume so that people looking for content can still > find it easily. Since a lot of people expect just to look in the "Handbook" and people have have direct links into to it, I think the notice of the change should be published so as many people as possible get the heads up. Perhaps even on announce@. Since there exist quite a lot of links directly into the Handbook, I think it would be a good idea to create dummy HTML files, for the section that's going to be moved. They would tell people that the Handbook has been split, and refresh after 10 seconds to the new page, instead of giving people a 404 error. I think it should be fairly trivial to auto generate those HTML files. It would require doing something special with for the build dir on www.FreeBSD.org, but I think it's worth it to avoid confusing users with dead links. --=20 Simon L. Nielsen FreeBSD Documentation Team --lrZ03NoBR/3+SXJZ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+6JPh9pcDSc1mlERAhduAJ49CVsvvF3DP5WGaJALC27LayADNQCgkiAb M9iqAbI0Nubdlxw06N+0lZk= =yCso -----END PGP SIGNATURE----- --lrZ03NoBR/3+SXJZ--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040719102831.GA33180>