Re: Where did the Developer docs go?

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

On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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

On Mon, Dec 5, 2011 at 4:18 PM, Thom Brown <thom(at)linux(dot)com> wrote:
> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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

On Mon, Dec 5, 2011 at 17:18, Thom Brown <thom(at)linux(dot)com> wrote:
> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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/

On 5 December 2011 16:24, Simon Riggs <simon(at)2ndquadrant(dot)com> wrote:
> On Mon, Dec 5, 2011 at 4:18 PM, Thom Brown <thom(at)linux(dot)com> wrote:
>> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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

Thom Brown <thom(at)linux(dot)com> writes:
> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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

On Mon, Dec 5, 2011 at 17:36, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> Thom Brown <thom(at)linux(dot)com> writes:
>> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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/

On Dec 5, 2011, at 11:39 AM, Magnus Hagander wrote:

> On Mon, Dec 5, 2011 at 17:36, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>> Thom Brown <thom(at)linux(dot)com> writes:
>>> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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?

Jonathan

On Mon, Dec 5, 2011 at 20:53, Jonathan S. Katz
<jonathan(dot)katz(at)excoventures(dot)com> wrote:
> On Dec 5, 2011, at 11:39 AM, Magnus Hagander wrote:
>
> On Mon, Dec 5, 2011 at 17:36, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Thom Brown <thom(at)linux(dot)com> writes:
>
> On 5 December 2011 16:06, Simon Riggs <simon(at)2ndquadrant(dot)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/

On Dec 6, 2011, at 9:53 AM, Magnus Hagander wrote:

> On Mon, Dec 5, 2011 at 20:53, Jonathan S. Katz
> <jonathan(dot)katz(at)excoventures(dot)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 that would 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 for new 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 linking to an old feature ;-)

Jonathan

On Tue, Dec 6, 2011 at 16:59, Jonathan S. Katz
<jonathan(dot)katz(at)excoventures(dot)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(dot)katz(at)excoventures(dot)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 that would 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 for new 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/

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