fix: docs build cleanup

ucp.dev site building cleanup:

- Stop setting latest alias in build_local.sh script, as it was updating latest alias to draft
- Add a symlink for /specifications/ to /latest/specifications/
- Update pages build for main to delete old files, and preserve version dirs

Author: wry-ry

.github/workflows/docs.yml

@@ -144,6 +144,9 @@ jobs:
           cp -r site/* .
           rm -rf site
 
+          # Add redirects for all specification files
+          ln -s latest/specification specification
+
           # Commit and push
           git add .
           git commit -m "Deploy root site from main" --allow-empty

.linkignore

@@ -1,2 +1,6 @@
 # Ignore ucp.dev dummy links
-https://ucp\.dev/specification/reference\?v=2026-01-11
+https://ucp\.dev/specification/reference\?v=2026-01-11
+
+# Ignore latest specification links because the target version folder is not pulled down during --main-only checks
+/latest/specification/.*
+latest/specification/.*

scripts/build_local.sh

@@ -112,16 +112,6 @@ export DOCS_MODE=spec
 export UCP_BUILD_VERSION="draft"
 mike deploy draft
 
-LATEST_VERSION=$(echo "$RELEASE_BRANCHES" | sed 's/release\///' | sort -r | head -n 1)
-
-if [ -n "$LATEST_VERSION" ]; then
-	echo "Aliasing 'latest' to $LATEST_VERSION"
-	mike alias "$LATEST_VERSION" latest --update-aliases
-else
-	echo "No release found, aliasing latest to draft"
-	mike alias draft latest --update-aliases
-fi
-
 echo ">>> Building Root Site"
 # Build root site FIRST so we establish the base (index.html, etc.)
 # Run in sub-shell or unset variable to be safe, though later steps don't use it