docs: use docs-only mode instead of having a landing page

The landing page is already cloudnative-pg.io, so we don't need another
one. We ensure that the latest release is the one users get when
they do not specify an exact version.

Signed-off-by: Francesco Canovai <[email protected]>

Author: fcanovai

scripts/import_docs.sh

@@ -139,7 +139,7 @@ fi
 
 echo "Updating versions_config.json: version ${VERSION_DIR} banner=${BANNER}"
 jq --arg version "$VERSION_DIR" --arg banner "$BANNER" \
-  '.[$version] = {"badge": true, "banner": $banner}' \
+  '.[$version] = {"badge": true, "banner": $banner, "path": $version}' \
   "$VERSIONS_CONFIG" > "${VERSIONS_CONFIG}.tmp" && \
   mv "${VERSIONS_CONFIG}.tmp" "$VERSIONS_CONFIG"
 
@@ -150,7 +150,7 @@ if [[ "$VERSION_DIR" == "$HIGHEST_VERSION" ]] && [[ "$IS_RC" == false ]]; then
   echo "Version ${VERSION_DIR} is the highest release - updating lastVersion in docusaurus.config.ts"
 
   # Update lastVersion in docusaurus.config.ts
-  sed -i.bak "s/lastVersion: '[^']*'/lastVersion: '${VERSION_DIR}'/" "$DOCUSAURUS_CONFIG" && \
+  sed -i.bak "s/lastVersion = '[^']*'/lastVersion = '${VERSION_DIR}'/" "$DOCUSAURUS_CONFIG" && \
     rm "${DOCUSAURUS_CONFIG}.bak"
 
   echo "Updated lastVersion to ${VERSION_DIR}"

website/docusaurus.config.ts

@@ -6,6 +6,8 @@ import type * as Preset from '@docusaurus/preset-classic';
 
 const versionsConfig = require('./versions_config.json') as Record<string, import('@docusaurus/plugin-content-docs').VersionOptions>;
 
+const lastVersion = '1.28';
+
 const config: Config = {
   title: 'CloudNativePG',
   tagline: 'Run PostgreSQL.The Kubernetes way.',
@@ -45,9 +47,9 @@ const config: Config = {
         docs: {
           path: 'docs',
           sidebarPath: require.resolve('./sidebars.js'),
-          routeBasePath: 'docs',
+          routeBasePath: '/',
           includeCurrentVersion: true, // Include the current version in the sidebar
-          lastVersion: '1.28',
+          lastVersion: lastVersion,
           versions: versionsConfig,
         },
         blog: false,
@@ -81,6 +83,7 @@ const config: Config = {
       logo: {
         alt: 'CloudNativePG Logo',
         src: 'img/hero_image.svg',
+        href: 'https://cloudnative-pg.io',
       },
       items: [
         {
@@ -92,7 +95,11 @@ const config: Config = {
         {
             type: 'docsVersionDropdown',
             position: 'right',
-            versions: ['current', '1.28', '1.27'],
+            versions: Object.keys(versionsConfig).sort((a, b) => {
+                if (a === 'current') return -1;
+                if (b === 'current') return 1;
+                return b.localeCompare(a, undefined, { numeric: true });
+            }),
         },
           {
               href: "https://github.com/cloudnative-pg/",
@@ -159,6 +166,19 @@ const config: Config = {
       darkTheme: prismThemes.dracula,
     },
   } satisfies Preset.ThemeConfig,
+  plugins: [
+      [
+          '@docusaurus/plugin-client-redirects',
+          {
+              redirects: [
+                  {
+                      to: `/${lastVersion}/`,
+                      from: '/',
+                  },
+              ],
+          },
+      ],
+  ],
 };
 
 export default config;

website/src/components/HomepageFeatures/index.tsx

@@ -6,10 +6,12 @@
   },
   "1.27": {
     "badge": true,
-    "banner": "none"
+    "banner": "none",
+    "path": "1.27"
   },
   "1.28": {
     "badge": true,
-    "banner": "none"
+    "banner": "none",
+    "path": "1.28"
   }
 }