From owner-cvs-all Tue Feb 27 3:22: 2 2001 Delivered-To: cvs-all@freebsd.org Received: from baerenklau.de.freebsd.org (baerenklau.de.freebsd.org [195.185.195.14]) by hub.freebsd.org (Postfix) with ESMTP id C0C6737B719; Tue, 27 Feb 2001 03:21:42 -0800 (PST) (envelope-from wosch@panke.de.freebsd.org) Received: (from uucp@localhost) by baerenklau.de.freebsd.org (8.8.8/8.8.8) with UUCP id MAA11835; Tue, 27 Feb 2001 12:21:41 +0100 (CET) (envelope-from wosch@panke.de.freebsd.org) Received: (from wosch@localhost) by paula.panke.de.freebsd.org (8.9.3/8.8.8) id MAA02111; Tue, 27 Feb 2001 12:20:27 +0100 (CET) (envelope-from wosch) Date: Tue, 27 Feb 2001 12:20:27 +0100 From: Wolfram Schneider To: Nik Clayton Cc: Wolfram Schneider , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: www/en Makefile Message-ID: <20010227122027.A2079@paula.panke.de.freebsd.org> References: <200102241031.f1OAVTZ82598@freefall.freebsd.org> <20010225064044.A68105@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0i In-Reply-To: <20010225064044.A68105@canyon.nothing-going-on.org>; from nik@FreeBSD.org on Sun, Feb 25, 2001 at 06:40:44AM +0000 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Nik, After your commit, the FAQ is 4 times accessable on the web server www.freebsd.org: http://www.freebsd.org/FAQ/ http://www.freebsd.org/docs/faq/ http://www.freebsd.org/docs/en/books/faq/ http://www.freebsd.org/docs/en_US.ISO_8859-1/books/faq/ same for the Handbook: http://www.freebsd.org/docs/en_US.ISO_8859-1/books/handbook/ http://www.freebsd.org/docs/en/books/handbook/ http://www.freebsd.org/docs/handbook/ http://www.freebsd.org/handbook/ and the committer guide 3 times (same for all other tutorials) http://www.freebsd.org/docs/en_US.ISO_8859-1/articles/committers-guide/ http://www.freebsd.org/docs/en/articles/committers-guide/ http://www.freebsd.org/tutorials/committers-guide/ This is confusing and not acceptable. A page which can be read on a web server will be read (Murphys Law). This will increase the robots load by several ten-thousend page views per day! In general, never use symlinks to directories on a web server. We are using the URLs /handbook, /FAQ and /tutorials for several years now and cannot change them. The URLs are hard-wired on installations, CDROMs, books, papers and users brain. If you have problems with installing the FAQ in /FAQ, fix your Makefiles. Building and installing from source was never easy and will not be. In the good old days it was just a `cvs co FAQ; cd FAQ; make' You did 1 year a go a re-organization of the doc tree with the long directory names (en_US.ISO_8859-1/books/faq) Several people objected and it was a long flame war. It was consensus that we *do not* change the directory structure of the web server. As the FreeBSD webmaster, I'm responsible that the web site is up and running and usably for our users. Major changes on the web site must be approved by me. I did not approved your hack, and you did not contacted me before your change. -Wolfram On 2001-02-25 06:40:44 +0000, Nik Clayton wrote: > On Sat, Feb 24, 2001 at 02:31:29AM -0800, Wolfram Schneider wrote: > > wosch 2001/02/24 02:31:29 PST > > > > Modified files: > > en Makefile > > Log: > > Undo rev 1.59 and don't build the docs directory > > > > Large URLs like > > > > http://www.FreeBSD.ORG/docs/en_US.ISO_8859-1/books/handbook/ > > > > are evil and hard to use for humans. There is no reason to move > > our handbooks 3 (!) directory levels deeper. > > I'm not proposing we go out of our way to publicise those URLs. You'll > notice that I've done nothing about the existing /handbook and /faq > directories, or the various Makefile contortions that we go through to > put things under a tutorials/ directory, or the various other horrible > hacks in the www/ build Makefiles. > > You'll also notice that the *only* place that uses these new paths is > the top level docs.html page. Nothing else on the site uses them (yet). > > [ The net effect of which is that we build some of the documentation at > least twice when we build the web site. Rome wasn't built in a day, > and I'm not going to go ripping out chunks of old infrastructure when > the new stuff can sit alongside it for a few days and get bedded down ] > > Long term, I think we need one canonical path for the documents. > Shortcuts (such as /handbook) which we're currently handling the web > server configuration should be replaced by symlinks, constructed as part > of the 'make install' process (particularly as the web server > configuration file is not stored anywhere under the www/ repo, so there > is (AFAIK) no way for our mirrors to know what nasty redirects we might > have in there. > > In fact, if you look under freefall:/usr/local/www/data/docs/ you'll see > some of those shortcuts in place now. -- Wolfram Schneider http://wolfram.schneider.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message