Add canonical urls to the documentation

Issue #3342 closed
Adrian created an issue

Right now the google index for the SA documentation is a mess. Links to 0.7 or 0.8 are quite common, even though all links in the google index should point to the latest stable version.

Readthedocs has an option to enable canonical urls, but it should be easy enough to do even without using RTD: https://support.google.com/webmasters/answer/139066?hl=en

Comments (8)

  1. Mike Bayer repo owner

    the read the docs document does not indicate that this feature is functional across versions. For example, I set it to "http://docs.sqlalchemy.org/en/latest/". This is not what the RTD documentation says; they seem to imply I can at best set it to "http://docs.sqlalchemy.org", so that the domain will be the "official" domain, not a URL like "sqlalchemy.readthedocs.org".

    E.g., RTD is not providing a canonical "prefix" for me here, just a domain. Please advise.

  2. Mike Bayer repo owner

    ok, it claims "We point all versions of your docs at the “latest” version as canonical". We'll see.

  3. Mike Bayer repo owner

    though that's a bad example because on latest that link is now declarative/index.html. maybe google figures that out.

  4. Log in to comment