[prev in list] [next in list] [prev in thread] [next in thread]
List: apache-docs
Subject: Re: /docs rewrite rules
From: "Astrid 'Kess' =?iso-8859-1?q?Ke=DFler?=" <kess () kess-net ! de>
Date: 2006-06-27 18:29:41
Message-ID: 200606272029.41212.kess () kess-net ! de
[Download RAW message or body]
On Tuesday 27 June 2006 18:25, Hiroaki Kawai wrote:
> > > I see.
> > >
> > > IMHO, we should not use /docs/mod/mod_xx.html any
> > > more and leave it as-is for historical reason.
> >
> > If we want to not-use /docs/something, we should get rid of it
> > altogether. If we don't want to get rid of it, it should point to the
> > most recent (stable) version.
>
> Agree.
No, disagree. We did use /docs/something in the past. And these docs pages are still \
valid.
As already said, especially by Joshua, there are a lot of reasons, to keep URIs \
stable. It's not only http://www.w3.org/Provider/Style/URI, Joshua pointed out some \
more reasons.
>
> > > By the way, in which page are you want to use
> > > http://httpd.apache.org/docs/mod/mod_xx.html
> > > syntax? Why you want to make it to point the
> > > recent version?
> >
> > These URLs exist, all around the internet, for various things. The help
> > bot in #apache uses them, for example.
If we want the bot to point to the current documentation, then these answers are \
wrong for a long time. The bot is no argument to change our URIs. Teach the bot to \
give correct answers. The use of /docs/current (nice idea) will fix this once and for \
all.
> >
> > It should point to the most recent version because otherwise people are
> > always looking at old docs, really, why do we /have/ newer versions, if
> > it's not because they're better - in some way - than the old?
>
> You mean, that the location /docs/mod/mod_xx.html is
> so distributed around the internet, that we want to
> navigate it to the current version, right?
> I agree that we want to make people use Apache2.2 because
> it is the best version available.
The better way would be (als also already sugested) to mark old docs being outdated \
and point to /docs/current. This will give the reader every information he needs \
without breaking URIs.
Breaking URIs one of the most painful things at the web, I know. There are several \
reasons to bookmark or link to a special URI. I really hate it to come back some \
month later and get totally different content (mostly without any information where \
to find the old content). Hell, what do the webmasters think, why I am noting just \
this special docs page from that special version?
> OK, I see the reason, and vote +1 for changing the rewrite rule.
>
As already voted: -1
Think of it as a veto, not only a vote.
There are severals ways to lead a visitor to the current docs version. I want us to \
use them instead of going the easiest (and arrogant) way of breaking existing URIs. \
Kess
> And I'd like to suggest adding ErrorDocument 404 /docs/ to that
> area so that people can know the current version, and check
> his httpd version, and continue reading the documentation.
>
> Thank you for replying me patiently. :-)
>
>
> ---
> Hiroaki Kawai
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
[Attachment #3 (text/html)]
<html><head><meta name="qrichtext" content="1" /></head><body \
style="font-size:10pt;font-family:Arial"> <p>On Tuesday 27 June 2006 18:25, Hiroaki \
Kawai wrote:</p> <p>> > > I see.</p>
<p>> > ></p>
<p>> > > IMHO, we should not use /docs/mod/mod_xx.html any</p>
<p>> > > more and leave it as-is for historical reason.</p>
<p>> ></p>
<p>> > If we want to not-use /docs/something, we should get rid of it</p>
<p>> > altogether. If we don't want to get rid of it, it should point to \
the</p> <p>> > most recent (stable) version.</p>
<p>></p>
<p>> Agree.</p>
<p></p>
<p>No, disagree. We did use /docs/something in the past. And these docs pages are \
still valid.</p> <p></p>
<p>As already said, especially by Joshua, there are a lot of reasons, to keep URIs \
stable. It's not only http://www.w3.org/Provider/Style/URI, Joshua pointed out some \
more reasons. </p> <p></p>
<p>></p>
<p>> > > By the way, in which page are you want to use</p>
<p>> > > http://httpd.apache.org/docs/mod/mod_xx.html</p>
<p>> > > syntax? Why you want to make it to point the</p>
<p>> > > recent version?</p>
<p>> ></p>
<p>> > These URLs exist, all around the internet, for various things. The \
help</p> <p>> > bot in #apache uses them, for example.</p>
<p></p>
<p>If we want the bot to point to the current documentation, then these answers are \
wrong for a long time. </p> <p>The bot is no argument to change our URIs. Teach the \
bot to give correct answers. The use of /docs/current (nice idea) will fix this once \
and for all.</p> <p></p>
<p>> ></p>
<p>> > It should point to the most recent version because otherwise people \
are</p> <p>> > always looking at old docs, really, why do we /have/ newer \
versions, if</p> <p>> > it's not because they're better - in some way - than \
the old?</p> <p>></p>
<p>> You mean, that the location /docs/mod/mod_xx.html is</p>
<p>> so distributed around the internet, that we want to</p>
<p>> navigate it to the current version, right?</p>
<p>> I agree that we want to make people use Apache2.2 because</p>
<p>> it is the best version available.</p>
<p></p>
<p>The better way would be (als also already sugested) to mark old docs being \
outdated and point to /docs/current. This will give the reader every information he \
needs without breaking URIs. </p> <p></p>
<p>Breaking URIs one of the most painful things at the web, I know. There are several \
reasons to bookmark or link to a special URI. I really hate it to come back some \
month later and get totally different content (mostly without any information where \
to find the old content). Hell, what do the webmasters think, why I am noting just \
this special docs page from that special version? </p> <p></p>
<p>> OK, I see the reason, and vote +1 for changing the rewrite rule.</p>
<p>></p>
<p></p>
<p>As already voted: -1 </p>
<p>Think of it as a veto, not only a vote.</p>
<p></p>
<p>There are severals ways to lead a visitor to the current docs version. I want us \
to use them instead of going the easiest (and arrogant) way of breaking existing \
URIs.</p> <p>Kess</p>
<p></p>
<p></p>
<p>> And I'd like to suggest adding ErrorDocument 404 /docs/ to that</p>
<p>> area so that people can know the current version, and check</p>
<p>> his httpd version, and continue reading the documentation.</p>
<p>></p>
<p>> Thank you for replying me patiently. :-)</p>
<p>></p>
<p>></p>
<p>> ---</p>
<p>> Hiroaki Kawai</p>
<p>></p>
<p>> ---------------------------------------------------------------------</p>
<p>> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org</p>
<p>> For additional commands, e-mail: docs-help@httpd.apache.org</p>
<p></p>
</body></html>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic