docs: kurrentdb-operator v1.1.0

Add docs for new features: scheduling constraints and read-only
replicas.

Also introduce versioning into the kurrentdb-operator docs.

Also updates the breadcrumb generation logic:
  - Eliminate breadcrumb-replacements.json; use README.md with
    frontmatter instead.  Secret json configs to mutate what is in the
    docs directory is hard to figure out.
  - If frontmatter's .title is set, use it as-is.  Only apply regexes
    designed for filenames to actual filenames.
  - Fix some broken frontmatters that were causing issues.

Author: rb-kurrent

docs/.vuepress/breadcrumb-replacements.json

@@ -1,6 +1,5 @@
 {
     "cloud": "Kurrent Cloud",
-    "server": "KurrentDB",
-    "kubernetes-operator": "Kubernetes Operator"
+    "server": "KurrentDB"
   }
-  
+

docs/.vuepress/client.ts

@@ -98,7 +98,10 @@ export default defineClientConfig({
                 }
             }, 0);
         });
-        addDynamicRoute("/server/kubernetes-operator", to => `/server/kubernetes-operator/getting-started/`);
+        const operatorLatest = __VERSIONS__.all.filter(x => x.id == 'kubernetes-operator')[0].versions[0].version;
+        addDynamicRoute("/server/kubernetes-operator", to => `/server/kubernetes-operator/${operatorLatest}/getting-started/`);
+        addDynamicRoute("/server/kubernetes-operator/:version", to => `/server/kubernetes-operator/${to.params.version}/getting-started/`);
+
         addDynamicRoute("/server/:version", to => `/server/${to.params.version}/quick-start/`);
         addDynamicRoute('/client/:lang',
             to => {

docs/.vuepress/components/breadCrumb.ts

@@ -71,20 +71,23 @@ export default defineComponent({
           if (notFound || meta.breadcrumbExclude) return null;
 
           // Get the original title from metadata or name
-          let title = meta.shortTitle || meta.title || name;
+          let title = meta.shortTitle || meta.title;
+          if (!title) {
+            // Generate a title using the name
+            title = name;
+            // Remove dashes, remove file extensions, and capitalize first letter
+            title = title.replace(/-/g, " ");
+            title = title.replace(/\..*$/, "");
+            title = title.trim();
+            title = title.charAt(0).toUpperCase() + title.slice(1);
+          }
 
           // Check if the title should be replaced
           const replacement = breadcrumbReplacements[title.toLowerCase()];
           if (replacement) {
             title = replacement;
           }
 
-          // Remove dashes, remove file extensions, and capitalize first letter
-          title = title.replace(/-/g, " ");
-          title = title.replace(/\..*$/, "");
-          title = title.trim();
-          title = title.charAt(0).toUpperCase() + title.slice(1);
-
           return {
             title,
             icon: meta.icon,

docs/.vuepress/configs/sidebar.ts

@@ -81,7 +81,6 @@ export const sidebarEn: EsSidebarOptions = {
   ],
   "/clients/grpc/": "structure",
   "/cloud/": "structure",
-  "/server/kubernetes-operator/": "structure",
   ...ver.getSidebars(),
   "/clients/tcp/dotnet/21.2/": "structure",
 };

docs/server/kubernetes-operator/README.md

@@ -1,5 +1,5 @@
-title: KurrentDB Kubernetes Operator
-order: 1
 ---
-
-# KurrentDB Kubernetes Operator
+# This directory exists to collect versions of the kubernetes operator docs,
+# but it should not appear as an extra breadcrumb layer.
+breadcrumbExclude: true
+---

docs/server/kubernetes-operator/v1.0.0/README.md

@@ -0,0 +1,5 @@
+---
+# title is for breadcrumb and sidebar nav
+title: Kubernetes Operator v1.0.0
+order: 1
+---