From owner-freebsd-doc Mon Apr 9 7:20:29 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (unknown [194.128.198.234]) by hub.freebsd.org (Postfix) with ESMTP id 045ED37B424; Mon, 9 Apr 2001 07:20:22 -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 f39EKBF13372; Mon, 9 Apr 2001 15:20:11 +0100 (BST) (envelope-from nik) Date: Mon, 9 Apr 2001 15:20:11 +0100 From: Nik Clayton To: Rasmus Kaj Cc: Nik Clayton , doc@FreeBSD.ORG, www@freebsd.org Subject: Re: http://www.freebsd.org/docs/, /FAQ/, /handbook/, and others Message-ID: <20010409152011.B13162@canyon.nothing-going-on.org> References: <20010314212034.A45244@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="9zSXsLTf0vkW971A" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: ; from kaj@hq.room33.com on Thu, Mar 15, 2001 at 09:24:51AM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --9zSXsLTf0vkW971A Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Mar 15, 2001 at 09:24:51AM +0100, Rasmus Kaj wrote: > As Jun Kuriyama said in another comment to this, the problem with > symlinks is that it creates duplicate info in search engines etc, and > the problems with symlinks to directories is that they creates *lots* > of such duplicate info. Of coures *lots* of symlinks to file is as > bad. Conversely, it serves to make the information more immediately available to anyone searching for it as well. > I still think redirects is the only good way to go, so here's my > response to your points about that: >=20 > a) I really don't see this as a problem. Setting up a web server on > a workstation to do some testing is quite simple enough. It's an avoidable overhead. If someone's got an hour to hack on the web site, I'd rather they spent that hour working on the web site, rather than first having to download, install, and configure a web server. If possible we should be catering to both groups of people. > b) This shouldn't be a problem eihter. I propose a text file in the > repository containg the redirects in server-independet format, and > some simple scripts to turn it into config for any web server. Send code. In the meantime, I'm going to turn this stuff on again in the web repo in the next few days -- no one's come up with a working alternative over the past few weeks, and we have more documentation coming in soon that doesn't fit in to our existing hierarchy (specifically, chapter 8 of the FreeBSD Corporate Networker's Guide, thanks to Addison Wesley). And the=20 doc build has not been working properly since this was turned off. The contents of FAQ/ and handbook/ will become symlinks to the files in doc/en_US.ISO_8859-1/books/. So these URLs will continue to work. After this has been done (it's an easy transition to make) then we can decide whether or not we want to make FAQ/ and handbook/ redirects. However, if we do, I would like the Makefiles to support the creation of symlinks, and have that be the default. We can have a variable (USE_REDIRECTS ? NOSYMLINKS ?) which the Makefiles can examine as necessary. 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 --- --9zSXsLTf0vkW971A Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjrRxRoACgkQk6gHZCw343UGpACfVUO/M+B1xFtmaJUK6tbBi8BN QasAn3mEJHRdHnABb/fJy+y1EMxMHmb/ =rWy/ -----END PGP SIGNATURE----- --9zSXsLTf0vkW971A-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message