Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 12 Jan 2003 12:36:10 +0200
From:      Peter Pentchev <roam@ringlet.net>
To:        "Bruce A. Mah" <bmah@FreeBSD.org>
Cc:        Udo Erdelhoff <ue@nathan.ruhr.de>, freebsd-doc@FreeBSD.org
Subject:   Re: 5.0 release docs (was Re: HEADSUP: doc/ tree tagging)
Message-ID:  <20030112103609.GC371@straylight.oblivion.bg>
In-Reply-To: <200301111736.h0BHaxph047160@intruder.bmah.org>
References:  <200301100535.h0A5Zqn3023272@intruder.bmah.org> <20030110124620.GB91718@nathan.ruhr.de> <200301101643.h0AGh3cO028415@intruder.bmah.org> <200301102123.h0ALNFIf031693@intruder.bmah.org> <20030110221508.GE91718@nathan.ruhr.de> <200301110435.h0B4Zbx5038652@intruder.bmah.org> <20030111172153.GA375@straylight.oblivion.bg> <200301111736.h0BHaxph047160@intruder.bmah.org>

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

--SUOF0GtieIMvvwua
Content-Type: text/plain; charset=windows-1251
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sat, Jan 11, 2003 at 09:36:59AM -0800, Bruce A. Mah wrote:
> If memory serves me right, Peter Pentchev wrote:
>=20
> > BTW, what happened to the idea of adding 'id' attributes to all
> > top-level sections in the books and articles, so there are no x3388.html
> > files on the website?  A patch was floating around; I could take a look
> > at updating it tomorrow if nobody minds.  IMHO, it would be a good thing
> > to have all our documentation in sensibly-named HTML files...
>=20
> Hey Peter--
>=20
> Yes, this would be a good idea.  I kind of wonder whether we should hold
> off committing it until after 5.0 (tagging, translations, you know) but
> I'd definitely like to see it happen sometime soon.  Other thoughts?

Actually, I think it would be best to do it before 5.0, if possible.
As people pointed out in the thread with the patch, having real names
on the HTML files holding the sections helps a lot WRT search engines:
it is much less likely that the search engine would cache a link to
outdated information in a file that is never updated because its name
changes, because it is much less likely that the file's name would
change :)

Still, I realize that I may have lingered a bit too much in looking into
this and pushing for this change.  I will send a patch later today, and
then we can see if it is reasonable to include it into the 5.0 release.

G'luck,
Peter

--=20
Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
because I didn't think of a good beginning of it.

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

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

iD8DBQE+IUUZ7Ri2jRYZRVMRAvG+AKCNHU9e/o4vmndB/MSUlQQWZYzCIACeJliw
CT29Cc4NWBEtbDADKKeexcI=
=NeK3
-----END PGP SIGNATURE-----

--SUOF0GtieIMvvwua--

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?20030112103609.GC371>