docs: import existing versions

Author: reluctantfuturist

.github/workflows/build-and-deploy.yml

@@ -162,6 +162,37 @@ jobs:
 
         echo "✅ Configuration patches applied"
 
+    - name: Import existing versioning artifacts
+      run: |
+        echo "📥 Importing existing versioning artifacts from repository..."
+        cd "${{ env.TEMP_DIR }}/llama-stack/docs"
+
+        # Copy existing versioned_docs if they exist
+        if [ -d "${{ github.workspace }}/versioned_docs" ]; then
+          cp -r "${{ github.workspace }}/versioned_docs" ./
+          echo "✅ Imported existing versioned_docs"
+        else
+          echo "ℹ️ No existing versioned_docs found (first version)"
+        fi
+
+        # Copy existing versioned_sidebars if they exist
+        if [ -d "${{ github.workspace }}/versioned_sidebars" ]; then
+          cp -r "${{ github.workspace }}/versioned_sidebars" ./
+          echo "✅ Imported existing versioned_sidebars"
+        else
+          echo "ℹ️ No existing versioned_sidebars found (first version)"
+        fi
+
+        # Copy existing versions.json if it exists (overrides what we loaded earlier)
+        if [ -f "${{ github.workspace }}/versions.json" ]; then
+          cp "${{ github.workspace }}/versions.json" ./
+          echo "✅ Imported existing versions.json"
+        else
+          echo "ℹ️ No existing versions.json found (first version)"
+        fi
+
+        echo "✅ Versioning artifacts import completed"
+
     - name: Build documentation
       run: |
         cd "${{ env.TEMP_DIR }}/llama-stack/docs"

local-build-test.sh

@@ -143,7 +143,36 @@ EOF
 
 echo "✅ Configuration patches applied"
 
-# Step 4: Build Docusaurus documentation
+# Step 4: Import existing versioning artifacts from repository
+echo "📥 Importing existing versioning artifacts from repository..."
+
+# Copy existing versioned_docs if they exist
+if [ -d "$WORKSPACE_DIR/versioned_docs" ]; then
+    cp -r "$WORKSPACE_DIR/versioned_docs" ./
+    echo "✅ Imported existing versioned_docs"
+else
+    echo "ℹ️ No existing versioned_docs found (first version)"
+fi
+
+# Copy existing versioned_sidebars if they exist
+if [ -d "$WORKSPACE_DIR/versioned_sidebars" ]; then
+    cp -r "$WORKSPACE_DIR/versioned_sidebars" ./
+    echo "✅ Imported existing versioned_sidebars"
+else
+    echo "ℹ️ No existing versioned_sidebars found (first version)"
+fi
+
+# Copy existing versions.json if it exists (overrides what we loaded earlier)
+if [ -f "$WORKSPACE_DIR/versions.json" ]; then
+    cp "$WORKSPACE_DIR/versions.json" ./
+    echo "✅ Imported existing versions.json"
+else
+    echo "ℹ️ No existing versions.json found (first version)"
+fi
+
+echo "✅ Versioning artifacts import completed"
+
+# Step 5: Build Docusaurus documentation
 echo "🏗️ Building Docusaurus documentation..."
 
 # Generate API docs first (required for current build)
@@ -191,7 +220,7 @@ touch "$DOCS_DIR/.nojekyll"
 
 echo "✅ Docusaurus content deployed"
 
-# Step 6: Update workspace artifacts (if we created a new version)
+# Step 7: Update workspace artifacts (if we created a new version)
 if [ "$BUILDING_LATEST" != "true" ]; then
     echo "📋 Updating workspace versioning artifacts..."
 
@@ -211,7 +240,7 @@ if [ "$BUILDING_LATEST" != "true" ]; then
     echo "✅ Updated workspace versions.json"
 fi
 
-# Step 7: Setup versioning files in deployed site
+# Step 8: Setup versioning files in deployed site
 echo "⚙️ Setting up versioning configuration files..."
 
 # Copy versioning files to deployment
@@ -220,7 +249,7 @@ cp versions.json "$DOCS_DIR/"
 
 echo "✅ Versioning files created"
 
-# Step 8: Verify deployment structure
+# Step 9: Verify deployment structure
 echo "🔍 Verifying deployment structure..."
 
 echo "Contents of docs directory:"
@@ -235,7 +264,7 @@ echo -e "\nVersioning files:"
 
 echo -e "\n✅ Structure verification complete"
 
-# Step 9: Start local server for testing
+# Step 10: Start local server for testing
 echo "🌐 Starting local development server..."
 echo "📍 Your documentation is available at: http://localhost:3000"
 echo "🔗 Main docs: http://localhost:3000/docs.html"