Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 4 Mar 2001 23:22:48 +0100
From:      Wolfram Schneider <wosch@panke.de.freebsd.org>
To:        Nik Clayton <nik@FreeBSD.ORG>
Cc:        Jun Kuriyama <kuriyama@imgsrc.co.jp>, doc@FreeBSD.ORG
Subject:   Re: cvs commit: www/en Makefile
Message-ID:  <20010304232247.C1647@paula.panke.de.freebsd.org>
In-Reply-To: <20010301145623.A3225@canyon.nothing-going-on.org>; from nik@FreeBSD.ORG on Thu, Mar 01, 2001 at 02:56:23PM %2B0000
References:  <200102241031.f1OAVTZ82598@freefall.freebsd.org> <20010225064044.A68105@canyon.nothing-going-on.org> <20010227122027.A2079@paula.panke.de.freebsd.org> <7mwva9y48r.wl@waterblue.imgsrc.co.jp> <20010301145623.A3225@canyon.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On 2001-03-01 14:56:23 +0000, Nik Clayton wrote:
> I'd like to 
> 
>   1.  Agree that all documentation installs in the website under a
>       single point.  Currently, I prefer docs/ (or doc/).

currently the single point is / and for the translated contents /<lang>/

if you change this for the english pages to
/docs/en_US.ISO_8859-1/books/handbook/

 - where will be the location of the japanese handbook?

1. /docs/ja_JP.eucJP/books/handbook
	or
2. /ja/docs/ja_JP.eucJP/books/handbook

IMHO both are confusing. with 1) we would have *two* /<lang>
subdirectories on the homepage, /<lang>/ and /docs/<lang>/
A link from /ja/docproj/who.html would point outside the /ja/
prefix to /docs/ja_JP.eucJP/books/handbook/


>   2.  Use symlinks to grandfather in existing shortcuts (/FAQ,
>       /handbook, and a handful of others) so that existing URLs work.

No.


>       Then our mirrors can be true mirrors, without having to see our
>       httpd.conf (or even run the same server software that we do).
> 
>   3.  Establish a policy that no new documentation should install 
>       directly under the document root.

Ok.


> Much, much, much longer term I'd like to consider moving the documentation 
> off on to its own subdomain, doc.freebsd.org or similar.  That's a
> sufficiently big project that I don't want to go anywhere near it at the
> moment, as we'd just get bogged down.

Why do you want move the documentation off the main web site? Who
would use the FreeBSD web site if there is no real contents???

There is already a docs.freebsd.org site for rare used documentation
and historically documents (info pages, 44BSD docs, mailing lists).


> We should also periodically monitor the error logs, as people learn and
> bookmark the new URLs.  Suppose that, right now, .../FAQ/ gets 10,000
> hits a month (I've got no idea what the true figure is).  Eventually
> that'll drop, as the new URLs become commonplace.  We could agree that
> when the figure drops to something like 50 hits a month (which could
> take a year or more) we replace .../FAQ/ with a message that says "This
> content has moved to...".

From my experience, people does not fix bookmarks.
I updated some weeks ago the apache web server on freefall. I did
a little experiment and removed all old redirects to test
how many dead links are in use and if users care about broken links.

There are many dead links in use and some users complaints.
So I added most redirects back. Some of the broken links are
dead since 4 or 5 years ...

I worked for a company which changed their name from foo-berlin.de
to foo.de. The company have a paid webmaster and the webmaster
contacted every other webmaster if he found a dead link to the
old domain. Even after 3 years, there are still dead links ...

-Wolfram

-- 
Wolfram Schneider <wosch@freebsd.org> http://wolfram.schneider.org

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010304232247.C1647>