Old doc pages 404 #21

Activity

1. jmealo commented on Dec 23, 2025

   

   jmealo

   on Dec 23, 2025

   More actions

   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...
           ],
         },
       ],
     ],
   };
2. jlroskens commented on Jan 6, 2026

   

   jlroskens

   on Jan 6, 2026

   More actions

   Besides several google search results resulting in 404s, it has also broken links across docs within cloudnative-pg docs.

   For example:

   • docs/1.28/backup has a recommendation to use the Barman Cloud Plugin
     Via [CNPG-I](https://github.com/cloudnative-pg/cnpg-i/) plugins: the CloudNativePG Community officially supports the [Barman Cloud Plugin](https://cloudnative-pg.io/plugin-barman-cloud/) for integration with object storage services.
   • plugin-barman-cloud docs pages are filled with dead links back to https://cloudnative-pg.io/documentation/. See Requirements for an example.

   The above has several broken links on just the intro page, but they are throughout the entire repo. This is especially frustrating when there are instructions at https://cloudnative-pg.io/docs/1.28/backup recommending the plugin over the native implementation, but the recommended approach is filled with dead links.

   I assume rolling this back would cause more problems but wondering why it was done in the first place. In any case, really needs redirects in place until all docs are updated.
3. jmealo commented on Jan 6, 2026

   

   jmealo

   on Jan 6, 2026

   More actions

   I think putting Cloudflare in front and doing rewrites is probably the best option.
4. gbartolini commented on Jan 15, 2026

   

   gbartolini

   on Jan 15, 2026

   Contributor

   More actions

   I have asked the CNCF if it is possible to get some help here.
5. gbartolini commented on Jan 18, 2026

   

   gbartolini

   on Jan 18, 2026

   Contributor

   More actions

   I have put a temporary patch with @sxd, through client-side HTTP redirects. This is related to #24.

   Check cloudnative-pg/cloudnative-pg.github.io#404
6. leonardoce

   added a commit that references this issue on Jan 20, 2026

   feat: add version 1.26 (unmaintained) (#30)

   ...

   e18e5e4
7. mnencia

   added 2 commits that reference this issue on Jan 20, 2026

   feat: add version 1.25 (unmaintained)

   ...

   da63481

   feat: add version 1.25 (unmaintained)

   ...

   742070a
8. gbartolini

   added a commit that references this issue on Jan 20, 2026

   feat: add version 1.25 (unmaintained) (#35)

   ...

   3ca3c04