Re: once more: documentation search indexing

From: Michael Christofides <michael(at)pgmustard(dot)com>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>, Andres Freund <andres(at)anarazel(dot)de>, PostgreSQL WWW <pgsql-www(at)lists(dot)postgresql(dot)org>
Subject: Re: once more: documentation search indexing
Date: 2022-03-16 10:32:27
Message-ID: CAFwT4nC3_engmpeqYvHqu=jhZi08DFL9Rr5+NZ30FrHpiLPoxg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

Sorry to resurrect an old thread, this seemed so close to going through.

> I agree with the UX tweak being needed -- I've missed that button a t
> least a couple of times myself, and I am the one who put it there :)
>

+1 for changing this, I also never saw the button somehow.

> I do think the bigger question is if we want the actual /current/ URL
> to be the canonical one, rather than the /<version number of current
> version>/?
>
> I would've guessed that's better? But again I don't realy know, that's
> a guess, so if it was considered and rejected for good reasons then
> ignore that comment :)
>

I think this is important, but that either would be a big improvement over
the status quo. I think there are a couple of advantages of going with
/current/ as the canonical URL though:

1. Search engines factor in being told what is canonical, but it is only
one factor they consider[0], so I think there'll be benefits of the URL we
mark as canonical not changing every year (although links that are only one
major version old would be a lot better than the status quo).

2. It would make it more common for people to link back to the /current/
URLs on Stack Overflow, in blog posts, and similar. In the vast majority of
cases this will improve the experience for folks following those links in
future, and it will also help search engines be confident that the
/current/ version is the canonical one.

Having said that, I'd favour pushing the proposed patch over doing nothing,
as it will still be a big improvement! Thanks for all the work on this so
far.

[0]:
https://developers.google.com/search/docs/advanced/crawling/consolidate-duplicate-urls

In response to

Responses

Browse pgsql-www by date

  From Date Subject
Next Message Jonathan S. Katz 2022-03-16 14:19:44 Re: once more: documentation search indexing
Previous Message Dave Page 2022-03-15 09:14:21 Re: Broken link on the Sponsors page