Re: Where did the Developer docs go? - Mailing list pgsql-www

From Jonathan S. Katz
Subject Re: Where did the Developer docs go?
Date
Msg-id D8A18118-40CE-484E-B28F-35C67F3CD69D@excoventures.com
Whole thread Raw
In response to Re: Where did the Developer docs go?  (Magnus Hagander <magnus@hagander.net>)
Responses Re: Where did the Developer docs go?  (Magnus Hagander <magnus@hagander.net>)
List pgsql-www
On Dec 6, 2011, at 9:53 AM, Magnus Hagander wrote:

> On Mon, Dec 5, 2011 at 20:53, Jonathan S. Katz
> <jonathan.katz@excoventures.com> wrote:
>> One thing raised on IRC:
>>
>> Going
>> to http://developer.postgresql.org/pgdocs/postgres/sql-createtable.html will
>> actually redirect just to the index,
>> i.e. http://www.postgresql.org/docs/devel/static/
>>
>> If all the URLs map 1-1 should we setup a rewrite rule?
>
> It can be done. It was not done for two reasons:
> 1) then people will never update their bookmarks ;)

Unfortunately neither will Google or the other search engines, or blog posts linking to a feature in the development
docs.(i.e. search "site:http://developer.postgresql.org/pgdocs" to see indexed pages) - from the user experience side
thatwould be a bit frustrating. 

Granted it's not like it's the stable docs where we do need that permanence, but I do think it's wise to make it easy
fornew users to find information, even if it means a few people do not update their bookmarks. 

> 2) i'm not entirely sure everything is 1-1. In particular, I think
> there may well be files left over from old versions of postgres in the
> old one that people still link to. I guess they'd still just get a 404
> in a different place (on the new site), so reason two holds much less
> weight than the first one.

But since it is old and not up-to-date with the developer docs, then they should update their bookmarks.  Or stop
linkingto an old feature ;-) 

Jonathan

pgsql-www by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: Where did the Developer docs go?
Next
From: Stefan Kaltenbrunner
Date:
Subject: Re: German FAQ: Broken Links