Can you add redirects

[afabri]

In the documentation of the CGAL library we have links to unordered map and set. As this has changed we have broken links (see our issue).
Wouldn't it make sense that you add redirections in the .htacess file at https://github.com/boostorg/website/?

[pdimov]

@glenfe may suggest a course of action here. Adding per-library things to the global .htaccess doesn't seem the right thing to do. Maybe Unordered should have stub html redirects in its dir.

[albert-github]

Problem occurs for:

• unordered
• utility

[glenfe]

Boost as whole only guarantees for a given library or tool that links relative to a specific version will continue to work. These are links relative to doc/libs/VERSION e.g. for Unordered for version 1.78.0 that is doc/libs/1_78_0/doc/html/unordered

i.e. It doesn't guarantee that links relative to libs/unordered or doc/libs/release will continue to work. Individual library authors can guarantee this themselves if they want, but we do not add redirects to .htaccess for this. So Unordered can add HTML files that redirect if they want to preserve compatibility, or they can suggest to users to link to specific versions (not "release" if they plan on breaking those links).

For parts of the Boost website not specific to library documentation, we can add redirects to .htaccess

[cmazakas]

Ideally dependents of Unordered would use versioned links so these kinds of things don't pop up but if you roll with the Boost release, pinning to release makes sense.

It seems like it's pretty straightforward to add a few dummy pages that contain the redirection tag. All we'd have to do is adding something like:

<meta http-equiv="Refresh" content="0; url='https://www.w3docs.com'" />

and this problem should sort itself out.

[afabri]

I don't know what you mean with pinned links, but we used https://www.boost.org/doc/libs/release/doc/html/boost/unordered_set.html which got redirected correctly for up to boost version 1.78.0. Starting with 1.79 this fails.

[pdimov]

Pinned links would mean linking to https://www.boost.org/doc/libs/1_78_0/doc/html/boost/unordered_set.html instead of the latest release.

[afabri]

But even if we had put 1.78 as pinned version there is something you have to fix:

And when you follow the invitation to "click here" this brings you to

which is the latest release of boost, but not the package.

[glenfe]

@afabri Yes. We need to have a better solution for things like that.

[pdimov]

In this case it's also that the documentation for Unordered switched from "integrated" to "standalone" so the links changed anyway.