Fix link to latest

docusaurus.config.js

@@ -222,6 +222,13 @@ module.exports = {
   ],
   customFields: {},
   plugins: [
+    [
+      './src/plugins/plugin-latest-api-doc',
+      {
+        latestBaseUrl: '/cloud-sdk/api/latest',
+        versions: '../static/api/versions.json'
+      }
+    ],
     [
       '@docusaurus/plugin-content-docs',
       {

src/components/LatestApiDoc.js

@@ -0,0 +1,13 @@
+import React from 'react';
+import { useLocation } from '@docusaurus/router';
+import BrowserOnly from '@docusaurus/BrowserOnly';
+
+export default function LatestApiDoc({ latestBaseUrl, versions }) {
+  const explicitLatestBaseUrl = [
+    ...latestBaseUrl.split('/').slice(0, -1),
+    versions[0]
+  ].join('/');
+  const loc = useLocation();
+  const newPath = loc.pathname.replace(latestBaseUrl, explicitLatestBaseUrl);
+  return <BrowserOnly>{() => (window.location.href = newPath)}</BrowserOnly>;
+}

src/plugins/plugin-latest-api-doc.js

@@ -0,0 +1,29 @@
+/**
+ * @prop latestBaseUrl - Base URL for the latest version. Must not have a trailing slash.
+ * @prop versions - Reference to the `versions.json` file relative to the `.docusaurus` directory.
+ */
+async function apiDocPlugin(context, { latestBaseUrl, versions }) {
+  return {
+    name: 'sap-cloud-sdk-api-doc-plugin',
+
+    async contentLoaded({ content, actions }) {
+      const { createData, addRoute } = actions;
+      const baseUrlJson = await createData(
+        'latestBaseUrl.json',
+        `"${latestBaseUrl}"`
+      );
+
+      addRoute({
+        path: `${latestBaseUrl}*`,
+        component: '@site/src/components/LatestApiDoc.js',
+        modules: {
+          latestBaseUrl: baseUrlJson,
+          versions
+        },
+        exact: false
+      });
+    }
+  };
+}
+
+module.exports = apiDocPlugin;