6:14 p.m.
Hi all.
Just noticed that the english release notes page on the static website
has the following URL:
http://fedora.redhat.com/docs/release-notes/fc5/release-notes-ISO/
The last "directory" contains a word already in the URL (release-notes)
and another word (ISO) that gives no useful information to the user. A
better URL would be:
http://fedora.redhat.com/docs/release-notes/fc5/
I am just mentioning this as something we should have in our minds for
the future, since short, clean URLs are always a Good Thing for all
(maintainers and users).
-Dim
--
Dimitris Glezos
Jabber ID: glezos(a)jabber.org, PGP: 0xA5A04C3B
http://dimitris.glezos.com/
"He who gives up functionality for ease of use
loses both and deserves neither." (Anonymous)
--
7:09 p.m.
On Wed, 2006-07-05 at 00:14 +0100, Dimitris Glezos wrote:
Hi all.
Just noticed that the english release notes page on the static website
has the following URL:
http://fedora.redhat.com/docs/release-notes/fc5/release-notes-ISO/
The last "directory" contains a word already in the URL (release-notes)
and another word (ISO) that gives no useful information to the user. A
better URL would be:
http://fedora.redhat.com/docs/release-notes/fc5/
I am just mentioning this as something we should have in our minds for
the future, since short, clean URLs are always a Good Thing for all
(maintainers and users).
+1. This is firmly in the province of the FDP (publishing of relnotes
on the Web). There are a number of folks who publish, and so sometimes
things skew a little. I'm not sure what the best practice is for moving
these -- we certainly don't want to 404 anyone who hits the old link. A
redirect page would do the trick, but it would take someone who knows
the One True Way to do that on the existing site.
--
Paul W. Frields, RHCE http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project Board: http://www.fedoraproject.org/wiki/Board
Fedora Documentation Project: http://fedora.redhat.com/projects/docs/
7:46 p.m.
O/H Paul W. Frields έγραψε:
On Wed, 2006-07-05 at 00:14 +0100, Dimitris Glezos wrote:
> Just noticed that the english release notes page on the static website
> has the following URL:
>
> http://fedora.redhat.com/docs/release-notes/fc5/release-notes-ISO/
>
> The last "directory" contains a word already in the URL (release-notes)
> and another word (ISO) that gives no useful information to the user. A
> better URL would be:
>
+1. This is firmly in the province of the FDP (publishing of relnotes
on the Web). There are a number of folks who publish, and so sometimes
things skew a little. I'm not sure what the best practice is for moving
these -- we certainly don't want to 404 anyone who hits the old link. A
redirect page would do the trick, but it would take someone who knows
the One True Way to do that on the existing site.
Prevention is the best way to deal with these issues.
A 301 redirect is the next best way. :)
--
Dimitris Glezos
Jabber ID: glezos(a)jabber.org, PGP: 0xA5A04C3B
http://dimitris.glezos.com/
"He who gives up functionality for ease of use
loses both and deserves neither." (Anonymous)
--
12:36 p.m.
On Wed, 2006-07-05 at 00:14 +0100, Dimitris Glezos wrote:
Hi all.
Just noticed that the english release notes page on the static website
has the following URL:
http://fedora.redhat.com/docs/release-notes/fc5/release-notes-ISO/
The last "directory" contains a word already in the URL (release-notes)
and another word (ISO) that gives no useful information to the user. A
better URL would be:
http://fedora.redhat.com/docs/release-notes/fc5/
Except there is a difference.
release-notes/fc5/ == an index.html that has links to:
* The as-shipped ISO notes with all translations
* The Web-only relnotes with all translations
So, the ISO does convey some meaning.
I agree that release-notes is redundant. :)
- Karsten
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
1:51 p.m.
O/H Karsten Wade έγραψε:
On Wed, 2006-07-05 at 00:14 +0100, Dimitris Glezos wrote:
> Hi all.
>
> Just noticed that the english release notes page on the static website
> has the following URL:
>
> http://fedora.redhat.com/docs/release-notes/fc5/release-notes-ISO/
>
> The last "directory" contains a word already in the URL (release-notes)
> and another word (ISO) that gives no useful information to the user. A
> better URL would be:
>
> http://fedora.redhat.com/docs/release-notes/fc5/
Except there is a difference.
release-notes/fc5/ == an index.html that has links to:
* The as-shipped ISO notes with all translations
* The Web-only relnotes with all translations
So, the ISO does convey some meaning.
Aha, I see. Then maybe we should choose a more meaningful word, because
"ISO" and "errata" are probably ambiguous for many people (even for
native-english-speaking ones). Some suggestions follow.
A clear, hierarchical one:
1. release-notes/fc5/
2. release-notes/fc5/latest/en/
3. release-notes/fc5/shipped/en/
Make "latest" the default document and keep the ISO one for historical
purposes (archived):
1. release-notes/fc5/
2. release-notes/fc5/en/
3. release-notes/fc5/shipped/en/
Alternative words for "latest": current, updated, up2date
Alternative words for "shipped": original, iso
The typically and conceptually correct structure is the first one. I
prefer "shipped" from it's above alternatives.
I suggest we should take a close look at the structure of the URLs of
the new website, *before* launching it. IMO, permanent, consistent URLs
are an important issue for any website seeking high quality and usability.
-dim
--
Dimitris Glezos
Jabber ID: glezos(a)jabber.org, GPG: 0xA5A04C3B
http://dimitris.glezos.com/
"He who gives up functionality for ease of use
loses both and deserves neither." (Anonymous)
--
6497
days inactive
6514
days old
websites@lists.fedoraproject.org
4 comments
3 participants
participants (3)
-
Dimitris Glezos -
Karsten Wade -
Paul W. Frields