Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 11 Feb 2003 20:22:16 -0800
From:      "Bruce A. Mah" <bmah@FreeBSD.org>
To:        Jun Kuriyama <kuriyama@imgsrc.co.jp>
Cc:        "Bruce A. Mah" <bmah@FreeBSD.org>, Ceri Davies <setantae@submonkey.net>, Peter Pentchev <roam@ringlet.net>, "Gary W. Swearingen" <swear@attbi.com>, freebsd-doc@FreeBSD.org
Subject:   Re: obsolete handbook pages at www.freebsd.org
Message-ID:  <20030212042216.GA26223@intruder.bmah.org>
In-Reply-To: <7mwuk6xlwo.wl@black.imgsrc.co.jp>
References:  <6fel6f7ctj.l6f@localhost.localdomain> <20030211080708.GA392@straylight.oblivion.bg> <20030211094420.GA72903@submonkey.net> <20030211165644.GA18115@intruder.bmah.org> <7mwuk6xlwo.wl@black.imgsrc.co.jp>

next in thread | previous in thread | raw e-mail | index | archive | help

--YiEDa0DAkWCtVeE4
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

If memory serves me right, Jun Kuriyama wrote:
> At Tue, 11 Feb 2003 08:56:44 -0800,
> Bruce A. Mah wrote:
> > I think what happens is that the *source* files are wiped out and
> > re-checked out on Sundays.  (Multiple times.)  The directory from
> > which the Web content is served isn't wiped at all.
>=20
> Hmm, I'll check around this later.

OK, thanks.

> > > That PR sounds a lot older; kuriyama, is this something you can help =
with?
> >=20
> > I could take a look on this, but I won't have many FreeBSD cycles for
> > another few days...Kuriyama-san may be able to get there first.
> > Probably want to couple this with a Web site rebuild to make sure we
> > aren't blowing away a "real" file.
>=20
> I've cleaned up build directory.  Next build (3 hours later) will
> build with clean source.
>=20
> But problem is not the source, but the destination directory. =20

Correct.  Cleaning the build directory won't help us here.

> Current
> webupdate script will not clean up the destination directory.  This is
> because reducing 404 errors.  If we use clean destination, we will got
> many 404s when everytime ID changed.

The alternative to 404s is serve up obsolete content, which is what
we're doing now.  Various Web caches and search engines (including the
FreeBSD search facility on our own Web server) keep references to the
old, obsolete pages.  We need to get *rid* of the old pages so that we
don't give stale content to users.  We've gotten a number of
complaints on doc@ about this.

> I think I should remove obsoleted pages after some period...

Some time ago, somebody (roam?) committed a patch that gives all of
the pages for the Handbook and FAQ meaningful filenames, so we don't
have the randomly-generated filenames anymore.  Therefore, the
cleaning out of the Handbook and FAQ directories should be a one-time
operation, barring a restructuring of either document.

(There are some other documents, such as the porters-handbook, where
this is still a problem.)

Thanks,

Bruce.

--YiEDa0DAkWCtVeE4
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.0 (FreeBSD)

iD8DBQE+Scv42MoxcVugUsMRAotcAKCHZ6b0IeQwcJHzfLrUL/TbaBkNiQCeNUWr
AJ35V7sS0XNJ1B3drVPD6qc=
=z+ho
-----END PGP SIGNATURE-----

--YiEDa0DAkWCtVeE4--

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?20030212042216.GA26223>