Old doc pages 404

[mtricht]

The old doc pages e.g. https://cloudnative-pg.io/documentation/1.28/ now give a 404 since it has been migrated to https://cloudnative-pg.io/docs/1.28/.
Perhaps a redirect would be in order to fix old links?

[jmealo]

Unless we put Cloudflare in front of Github Pages, it looks like we'd need to do client-side redirects:

https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-client-redirects
It says these are always inactive in development, and only active in production, so during testing, make sure you're on a production build.

createRedirects(existingPath) {
  // For every /docs/X path, also create /documentation/X
  if (existingPath.startsWith('/docs/')) {
    return existingPath.replace('/docs/', '/documentation/');
  }
  return undefined;
}

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-client-redirects',
      {
        createRedirects(existingPath) {
          // Redirect old /documentation/ URLs to new /docs/ URLs
          if (existingPath.includes('/docs/')) {
            // Create redirects from /documentation/{version}/{page} to /docs/{version}/{page}
            return [
              existingPath.replace('/docs/', '/documentation/'),
            ];
          }
          return undefined;
        },
        // Or explicit redirects for specific pages
        redirects: [
          {
            to: '/docs/1.28/',
            from: ['/documentation/current/', '/documentation/1.28/'],
          },
          // Add more as needed...
        ],
      },
    ],
  ],
};