Thread: Where did the Developer docs go?

Where did the Developer docs go?

From
Simon Riggs
Date:
http://developer.postgresql.org/pgdocs/postgres/index.html

used to go somewhere useful and now gives 404

Where should I go to see the latest build of the docs?

--
 Simon Riggs                   http://www.2ndQuadrant.com/
 PostgreSQL Development, 24x7 Support, Training & Services


Re: Where did the Developer docs go?

From
Thom Brown
Date:
On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
> http://developer.postgresql.org/pgdocs/postgres/index.html
>
> used to go somewhere useful and now gives 404
>
> Where should I go to see the latest build of the docs?

It's now moved to: http://www.postgresql.org/docs/devel/static/

-- 
Thom


Re: Where did the Developer docs go?

From
Magnus Hagander
Date:
On Mon, Dec 5, 2011 at 17:18, Thom Brown <thom@linux.com> wrote:
> On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
>> http://developer.postgresql.org/pgdocs/postgres/index.html
>>
>> used to go somewhere useful and now gives 404
>>
>> Where should I go to see the latest build of the docs?
>
> It's now moved to: http://www.postgresql.org/docs/devel/static/

Indeed.

I have (at leas tI think I have) now updated the redirect rules to
actually capture links directly into the docs as well and not just the
/docs/ page itself (which is what was linked from the old website)

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/


Re: Where did the Developer docs go?

From
Thom Brown
Date:
On 5 December 2011 16:24, Simon Riggs <simon@2ndquadrant.com> wrote:
> On Mon, Dec 5, 2011 at 4:18 PM, Thom Brown <thom@linux.com> wrote:
>> On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
>>> http://developer.postgresql.org/pgdocs/postgres/index.html
>>>
>>> used to go somewhere useful and now gives 404
>>>
>>> Where should I go to see the latest build of the docs?
>>
>> It's now moved to: http://www.postgresql.org/docs/devel/static/
>
> There's no redirection to new URL and the new URL is not accessible
> via the docs page.
>
> How do you know about this and I don't?

I found the reference to it on this page:
http://www.postgresql.org/developer/testing/

-- 
Thom


Re: Where did the Developer docs go?

From
Simon Riggs
Date:
On Mon, Dec 5, 2011 at 4:18 PM, Thom Brown <thom@linux.com> wrote:
> On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
>> http://developer.postgresql.org/pgdocs/postgres/index.html
>>
>> used to go somewhere useful and now gives 404
>>
>> Where should I go to see the latest build of the docs?
>
> It's now moved to: http://www.postgresql.org/docs/devel/static/

There's no redirection to new URL and the new URL is not accessible
via the docs page.

How do you know about this and I don't?

--
 Simon Riggs                   http://www.2ndQuadrant.com/
 PostgreSQL Development, 24x7 Support, Training & Services


Re: Where did the Developer docs go?

From
Tom Lane
Date:
Thom Brown <thom@linux.com> writes:
> On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
>> Where should I go to see the latest build of the docs?

> It's now moved to: http://www.postgresql.org/docs/devel/static/

Like Simon, I was unaware of this relocation.  Is there a reason we
don't have a redirect from the longstanding location?
        regards, tom lane


Re: Where did the Developer docs go?

From
Magnus Hagander
Date:
On Mon, Dec 5, 2011 at 17:36, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Thom Brown <thom@linux.com> writes:
>> On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
>>> Where should I go to see the latest build of the docs?
>
>> It's now moved to: http://www.postgresql.org/docs/devel/static/
>
> Like Simon, I was unaware of this relocation.  Is there a reason we
> don't have a redirect from the longstanding location?

You were not unaware, because you were in on a thread where we
informed about this :P

That said, there was a redirect. It just didn't work properly. It now
works properly.

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/


Re: Where did the Developer docs go?

From
"Jonathan S. Katz"
Date:
On Dec 5, 2011, at 11:39 AM, Magnus Hagander wrote:

On Mon, Dec 5, 2011 at 17:36, Tom Lane <tgl@sss.pgh.pa.us> wrote:
Thom Brown <thom@linux.com> writes:
On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
Where should I go to see the latest build of the docs?

It's now moved to: http://www.postgresql.org/docs/devel/static/

Like Simon, I was unaware of this relocation.  Is there a reason we
don't have a redirect from the longstanding location?

You were not unaware, because you were in on a thread where we
informed about this :P

That said, there was a redirect. It just didn't work properly. It now
works properly.

One thing raised on IRC:


If all the URLs map 1-1 should we setup a rewrite rule?

Jonathan

Re: Where did the Developer docs go?

From
Magnus Hagander
Date:
On Mon, Dec 5, 2011 at 20:53, Jonathan S. Katz
<jonathan.katz@excoventures.com> wrote:
> On Dec 5, 2011, at 11:39 AM, Magnus Hagander wrote:
>
> On Mon, Dec 5, 2011 at 17:36, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>
> Thom Brown <thom@linux.com> writes:
>
> On 5 December 2011 16:06, Simon Riggs <simon@2ndquadrant.com> wrote:
>
> Where should I go to see the latest build of the docs?
>
>
> It's now moved to: http://www.postgresql.org/docs/devel/static/
>
>
> Like Simon, I was unaware of this relocation.  Is there a reason we
>
> don't have a redirect from the longstanding location?
>
>
> You were not unaware, because you were in on a thread where we
> informed about this :P
>
> That said, there was a redirect. It just didn't work properly. It now
> works properly.
>
>
> 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 ;)

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.

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/


Re: Where did the Developer docs go?

From
"Jonathan S. Katz"
Date:
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

Re: Where did the Developer docs go?

From
Magnus Hagander
Date:
On Tue, Dec 6, 2011 at 16:59, Jonathan S. Katz
<jonathan.katz@excoventures.com> wrote:
>
> 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. 

Ok, I've added a redirect for this. Hopefully it is correct...




--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/


Re: Where did the Developer docs go?

From
"Jonathan S. Katz"
Date:
On Dec 8, 2011, at 1:38 PM, Magnus Hagander wrote:

> Ok, I've added a redirect for this. Hopefully it is correct...

All my tests appear to be working - picking random links from the Google index redirect properly.

Thanks Magnus!

Jonathan