News for hackers. Stuff that matters.
Re:PostgreSQL website – new design now live by jrobn on Wednesday April 18, 2018 @06:51PM (#16871957)
The documentation pages are all that matter, and quite frankly, they are great.
Re:PostgreSQL website – new design now live by ximeng on Wednesday April 18, 2018 @06:57PM (#16871995)
Except that every Google search returns a result from a different random version number.
Re:PostgreSQL website – new design now live by dspillett on Wednesday April 18, 2018 @07:23PM (#16872140)
They can't really control that as a number of external factors part into Google's rankings (i.e. links from elsewhere), other than to make navigation to the right version easy which they seem to have managed (in, my, admittedly limited, experience there is always a version selection in the page head and the links go where you'd expect).
Re:PostgreSQL website – new design now live by codetrotter on Wednesday April 18, 2018 @10:08PM (#16872826)
They could straight up disallow the versioned pages in their robots.txt and for the current version they could have a full copy of the docs without version number in the URL that instead has .../current/... and those pages would be allowed for crawlers to index. Then people could jump to older versions manually from there if they needed to instead of everyone having to endure the land-on-an-arbitrary-version-number-page annoyance.

That really is my only problem with the postgresql docs though and that’s saying something. The content itself of the postgresql docs is of stellar quality.

Re:PostgreSQL website – new design now live by slavik81 on Thursday April 19, 2018 @07:07AM (#16874853)
Blocking the pages in robots.txt will remove them from the Wayback Machine. That sucks.

Qt did that for their documentation when they changed ownership and moved their website. They didn't migrate the old documentation, either. This made updating broken links much more difficult because I couldn't easily read the pages they originally pointed to.

Re:PostgreSQL website – new design now live by h1d on Thursday April 19, 2018 @01:05AM (#16873458)
Not sure how exactly Google works but if you just block versioned pages out, won't they just not show up instead of somehow pulling the latest static URL in the same ranked position?

Maybe better to specify canonical URL as the latest one.

Re:PostgreSQL website – new design now live by ximeng on Wednesday April 18, 2018 @09:54PM (#16872761)
The above comment is one of my most upvoted ever. It's annoying to have to click twice to get to the latest version. Maybe they make it too easy to get to old versions - I don't think I've ever seen a link to Wikipedia that points to an old version of a page.

Not saying this is an easy problem to solve, and the documentation is mostly pretty great, but this definitely bugs me and apparently a bunch of other people too.

Re:PostgreSQL website – new design now live by marcosdumay on Wednesday April 18, 2018 @10:21PM (#16872874)
Old Wikipedia pages are just dated and not useful as a starting point. Documentation for old versions of Postgres are the most up to date page for anybody using that version.

I am one of the people that gave you an upvote, but this is not a fair comparison at all.

Re:PostgreSQL website – new design now live by ximeng on Wednesday April 18, 2018 @10:33PM (#16872921)
Not aiming to be unfair to postgres - it's not an easy problem and the documentation is great, and it is different to Wikipedia where old content is generally objectively worse.

I guess for postgres 80% of people would be happy with always landing on the current version, and making an extra click or adding a version to their search if they really need documentation for older versions. Maybe adding a brief version history at the bottom of documentation pages would reduce the need for old versions even further.

Re:PostgreSQL website – new design now live by kingbirdy on Wednesday April 18, 2018 @10:55PM (#16873016)
I think a solution might be to make links to the latest version redirect to a v/latest/ which redirects to the new latest version across upgrades. For each url v/1.2/docs if 1.2 is the new version, then it redirects to v/latest/docs and when copy-pasted to e.g. stack overflow, when someone comes along later when it's in version 1.5, it serves the v1.5 docs. So the latest Google crawl will see mostly v/latest/docs links, it will always serve those at the top of search results for docs, and then no matter what those search results at the latest version of docs.
Re:PostgreSQL website – new design now live by ximeng on Wednesday April 18, 2018 @11:37PM (#16873149)
This would help!

There are no direct links between the urls below which both have the same content.

https://www.postgresql.org/docs/current/static/index.html https://www.postgresql.org/docs/10/static/index.html

You have to click to another page and back again to change to the "current" link if you're on the "10" link.

Re:PostgreSQL website – new design now live by xemoka on Wednesday April 18, 2018 @07:23PM (#16872141)
Would defining a canonical page, `<link rel="canonical" href="...">`, be the solution to this?
Re:PostgreSQL website – new design now live by jimktrains2 on Wednesday April 18, 2018 @08:44PM (#16872525)
It's not canonical though, it's for different versions, they're not the same page.
Re:PostgreSQL website – new design now live by majewsky on Thursday April 19, 2018 @04:56AM (#16874356)
Maybe we need <link rel="preferred-search-result">
Re:PostgreSQL website – new design now live by jimktrains2 on Friday April 20, 2018 @11:04AM (#16885339)
I wonder if this could be "done" or managed in some way using a sitemap or via google's site search admin (I forget its exact name). Using robots to disallow old versions seems like an awfully big hammer.
Re:PostgreSQL website – new design now live by JoshMnem on Wednesday April 18, 2018 @09:54PM (#16872762)
You can add a version number to the query to get a specific version:

https://www.google.com/search?q=postgres+functions+9.1

Re:PostgreSQL website – new design now live by karmakaze on Thursday April 19, 2018 @12:47AM (#16873398)
I just follow a near-version link and edit the version number in the URL, then presto.
Re:PostgreSQL website – new design now live by gsich on Wednesday April 18, 2018 @09:44PM (#16872729)
There is a version link at the top.
Re:PostgreSQL website – new design now live by siruncledrew on Wednesday April 18, 2018 @11:24PM (#16873112)
Idk, the examples are really the best part of the documentation to me personally, but they are all the way at the bottom of the page. The description and options sections just remind me of man pages. I would prefer more of a readthedocs style.
Re:PostgreSQL website – new design now live by beefhash on Wednesday April 18, 2018 @11:37PM (#16873151)
Just hit the "End" key to scroll to the bottom?

Incidentally, UNIX/Linux man pages also put the examples section near the end.

Re:PostgreSQL website – new design now live by gsich on Wednesday April 18, 2018 @09:45PM (#16872731)
This was the first thing I checked, thankfully they stayed the same.