Date: Tue, 27 Feb 2001 12:14:01 +0000 From: Nik Clayton <nik@freebsd.org> To: Wolfram Schneider <wosch@panke.de.freebsd.org> Cc: Nik Clayton <nik@FreeBSD.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: www/en Makefile Message-ID: <20010227121401.A2631@canyon.nothing-going-on.org> In-Reply-To: <20010227122027.A2079@paula.panke.de.freebsd.org>; from wosch@panke.de.freebsd.org on Tue, Feb 27, 2001 at 12:20:27PM %2B0100 References: <200102241031.f1OAVTZ82598@freefall.freebsd.org> <20010225064044.A68105@canyon.nothing-going-on.org> <20010227122027.A2079@paula.panke.de.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Feb 27, 2001 at 12:20:27PM +0100, Wolfram Schneider wrote: > 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/ <snip> Yep. As I said, this is a transitional period. I wasn't going to disable the existing builds while the new stuff is bedding down. Once the new stuff is bedded down (and it looks like it is, the web site is building fine with a reverted www/en/Makefile) we can start diking out chunks of the duplicated stuff and putting in symlinks. > 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/ Actually, it's not the same for all of them, because of the ad hoc hackery we have in the various Makefiles to pull things like the FDP primer, or the porters-handbook in to other places in the tree. > This is confusing and not acceptable. I agree. This is why it's short term only (it would be even shorter term if I could make some progress on this). > A page which can be read on a web server will be read (Murphys Law). Only if you link to it. It's also possible to tell web robots not to spider certain pages, so that (for example) the only spider the FAQ in one location. > 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. The alternative is redirects in the server config file. Which means that each web site mirror must either run the same server software, and config file (which is tricky, because we don't publish the config file, and even then, I don't want to mandate that mirrors have to run the same software). > 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. I agree. /handbook should be a symlink to docs/en*/books/handbook, /FAQ (and /faq, which doesn't exist) docs/en*/books/faq, /tutorials should probably redirect to the new docs.html, and so on. Over time, we can migrate the existing web pages which use URLs like /handbook to use the new scheme, if its deemed necessary -- *note* that we don't have to do this bit if we don't want to. > If you have problems with installing the FAQ in /FAQ, fix your > Makefiles. Have you looked at the hoops that the docs have to jump through in tutorials/Makefile to install in the right place? It's ugly, error prone, and makes it harder for people who want to contribute to the infrastructure to understand what's going on. > Building and installing from source was never easy and will > not be. I don't see why it can't be. And I don't see why we shouldn't push to make it easy (or easier, at any rate). > In the good old days it was just a `cvs co FAQ; cd FAQ; make' Yeah, well, we've moved on since then. > 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. I'm not changing the directory structure of the web server. I'm adding to it. Over time, I expect that the *implementation* of the existing structure will change, to use symlinks to support some of the existing structure, instead of having to check things out multiple times, or build them multiple times. > As the FreeBSD webmaster, I'm responsible that the web site is up and > running and usably for our users. I agree. Which doesn't explain the unanswered messages to the webmaster@ alias (some of which you just forward on to doc@ instead of fixing them yourself), or that your last contribution to a discussion on -doc was (by my records) October last year. Since that time there have been patch submissions to the www/ tree by people like Neil Blakey-Milner which have gone unreviewed by you (at least in public). N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery 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?20010227121401.A2631>