Date: Tue, 27 Feb 2001 12:20:27 +0100 From: Wolfram Schneider <wosch@panke.de.freebsd.org> To: Nik Clayton <nik@FreeBSD.org> Cc: Wolfram Schneider <wosch@FreeBSD.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: www/en Makefile Message-ID: <20010227122027.A2079@paula.panke.de.freebsd.org> In-Reply-To: <20010225064044.A68105@canyon.nothing-going-on.org>; from nik@FreeBSD.org on Sun, Feb 25, 2001 at 06:40:44AM %2B0000 References: <200102241031.f1OAVTZ82598@freefall.freebsd.org> <20010225064044.A68105@canyon.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <wosch@FreeBSD.org> http://wolfram.schneider.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010227122027.A2079>