docs icon indicating copy to clipboard operation
docs copied to clipboard

Archive cross-version documentation for v22.2 and earlier

Open ebembi-crdb opened this issue 1 month ago • 4 comments

Summary

Complete 3-step cross-version archival process removing support for v22.2, v22.1, v21.2, v21.1, v20.2, and v2.1 documentation versions. This follows the established pattern of archiving unsupported versions while preserving access through minimal infrastructure.

Changes Made

🗂️ Asset Cleanup

  • Delete 1,769 archived version image assets from images/v2.1/, images/v20.2/, images/v21.1/, images/v21.2/, images/v22.1/, images/v22.2/
  • Reduces repository size and eliminates unused assets

🔗 Cross-Version Link Fixes

  • Fix 40+ cross-version references to point to supported versions or archived documentation
  • Update backward-incompatible files (9 files): Convert v22.2 Jekyll links to v23.2 relative paths
  • Fix show-ranges deprecation notices: Replace v22.2 links with archived documentation references
  • Fix release notes and Kubernetes upgrade references across all supported versions

🛠️ Infrastructure Improvements

  • Add Jekyll SSL certificate bypass for Ruby 3.4.3 + macOS compatibility (openssl_fix.rb)
  • Update Gemfile with Ruby 3.x compatibility gems (csv, logger, base64, bigdecimal, mutex_m)
  • Fix Liquid syntax errors in image paths caused by global replacements

📋 Link Verification

  • All corrected links verified to exist and function properly
  • Cross-version references now cleanly separated (v23.1+ supported)
  • Backward-incompatible links consistently point to v23.2 (earliest supported version)

Archival Strategy

This implementation follows the established 3-step archival process:

  1. Remove cross-version links - All references to archived versions updated
  2. Delete archived assets - 1,769 image files removed from archived versions
  3. Use minimal infrastructure - Leverages existing stub pages (releases/v*.md) that redirect to archived documentation

Files Changed

  • 24 documentation files with cross-version link fixes
  • 1,769 image assets deleted from archived versions
  • 9 backward-incompatible files updated across all supported versions (v23.1-v25.4)

ebembi-crdb avatar Oct 27 '25 11:10 ebembi-crdb