feat(sidebar): use autogenerated sidebar configuration

Replace manual sidebar entries with Docusaurus autogenerated
sidebar using document metadata and category files, simplifying
maintenance and reducing manual configuration overhead.

The import script now creates autogenerated sidebar config for
new versions on first import, preserving any later customizations.

Closes #20

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>

Author: mnencia

scripts/import_docs.sh

@@ -108,6 +108,7 @@ if [[ "$IS_MAIN" == true ]]; then
   echo "Copying imported docs -> ./website/docs"
   mkdir -p ./website/docs
   rsync -av --delete "$SOURCE_PATH/" --exclude "css" ./website/docs/
+
   echo "Updated ./docs from main — import completed."
   exit 0
 fi
@@ -120,10 +121,29 @@ TARGET_DIRECTORY="./website/versioned_docs/version-${VERSION_DIR}"
 echo "Copying imported docs -> ${TARGET_DIRECTORY}"
 rsync -av --delete "$SOURCE_PATH/" --exclude "css" "${TARGET_DIRECTORY}"
 
+# Create autogenerated sidebar configuration for this version if it doesn't exist
+SIDEBAR_TARGET_DIR="./website/versioned_sidebars"
+SIDEBAR_TARGET_FILE="$SIDEBAR_TARGET_DIR/version-${VERSION_DIR}-sidebars.json"
+
+if [[ ! -f "$SIDEBAR_TARGET_FILE" ]]; then
+  echo "Creating autogenerated sidebar config for version ${VERSION_DIR}"
+  mkdir -p "$SIDEBAR_TARGET_DIR"
+  cat > "$SIDEBAR_TARGET_FILE" <<'SIDEBAR_EOF'
+{
+  "docs": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}
+SIDEBAR_EOF
+else
+  echo "Sidebar config for version ${VERSION_DIR} already exists, keeping it"
+fi
+
 # Add the new version to versions.json if not already present
-if ! grep -q "\"${VERSION_DIR}\"" versions.json 2>/dev/null; then
-  # Import the new version in the correct folder
-  cp "./website/sidebar_config.json" "./website/versioned_sidebars/version-${VERSION_DIR}-sidebars.json"
+if ! grep -q "\"${VERSION_DIR}\"" "$VERSIONS_JSON" 2>/dev/null; then
   jq --arg version "$VERSION_DIR" \
         '. = [$version] + . | unique' \
         "$VERSIONS_JSON" > "${VERSIONS_JSON}.tmp" && \

website/docs/appendixes/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "Appendixes",
+  "position": 600,
+  "link": {
+    "type": "generated-index"
+  }
+}

website/docs/cncf-projects/_category_.json

@@ -0,0 +1,7 @@
+{
+  "label": "CNCF Projects Integrations",
+  "position": 590,
+  "link": {
+    "type": "generated-index"
+  }
+}

website/sidebar_config.json

@@ -1,79 +1,8 @@
 {
   "docs": [
-    "index",
-    "before_you_start",
-    "use_cases",
-    "architecture",
-    "installation_upgrade",
-    "quickstart",
-    "image_catalog",
-    "bootstrap",
-    "database_import",
-    "security",
-    "instance_manager",
-    "scheduling",
-    "resource_management",
-    "failure_modes",
-    "rolling_update",
-    "replication",
-    "logical_replication",
-    "backup",
-    "wal_archiving",
-    "recovery",
-    "service_management",
-    "postgresql_conf",
-    "declarative_role_management",
-    "declarative_database_management",
-    "tablespaces",
-    "operator_conf",
-    "cluster_conf",
-    "storage",
-    "labels_annotations",
-    "monitoring",
-    "logging",
-    "certificates",
-    "ssl_connections",
-    "applications",
-    "connection_pooling",
-    "replica_cluster",
-    "kubernetes_upgrade",
-    "postgres_upgrades",
-    "kubectl-plugin",
-    "failover",
-    "troubleshooting",
-    "fencing",
-    "declarative_hibernation",
-    "postgis",
-    "e2e",
-    "container_images",
-    "imagevolume_extensions",
-    "cnpg_i",
-    "operator_capability_levels",
-    "controller",
-    "samples",
-    "networking",
-    "benchmarking",
-    "faq",
-    "cloudnative-pg.v1",
-    "supported_releases",
-    "preview_version",
-    "release_notes",
     {
-      "type": "category",
-      "label": "CNCF Projects Integrations",
-      "items": [
-        "cncf-projects/external-secrets",
-        "cncf-projects/cilium"
-      ]
-    },
-    {
-      "type": "category",
-      "label": "Appendixes",
-      "items": [
-        "appendixes/backup_volumesnapshot",
-        "appendixes/backup_barmanobjectstore",
-        "appendixes/object_stores"
-      ]
+      "type": "autogenerated",
+      "dirName": "."
     }
   ]
 }