Move PDF generation to dedicated VM and unify documentation publishing

[konard]

🎯 Objective

Optimize documentation publishing by moving PDF generation to dedicated virtual machines and unifying the documentation publishing process as requested in #59.

📋 Issue Reference

Fixes #59

🚀 Implementation

1. PDF Generation Optimization

• Dedicated VM: Moved PDF generation to self-hosted runners with pdf-generation label
• Performance Improvement: Heavy LaTeX processing no longer blocks other CI jobs
• Artifact-based Workflow: PDF generated once and reused by documentation publisher

2. Unified Documentation Publishing

• Single Landing Page: Created unified index with navigation for both API docs and PDF
• Graceful Fallback: Documentation publishes successfully even if PDF generation fails
• Improved UX: Users get one entry point for all documentation types

3. Script Unification

• Local Script: Added .scripts/publish-unified-docs.sh for unified documentation publishing
• React-deep-tree Integration: Incorporated patterns from react-deep-tree publishing approach
• Maintainable: Script is versioned with the repository for easier updates

🔄 Workflow Changes

Before:

generatePdfWithCode:
  runs-on: ubuntu-latest  # Slow LaTeX processing blocks CI
  
publishDocumentation:  
  runs-on: ubuntu-latest
  needs: [findChangedCsFiles]  # Independent jobs

After:

generatePdfWithCode:
  runs-on: [self-hosted, pdf-generation]  # Dedicated fast VM
  # Uploads PDF as artifact
  
publishDocumentation:
  runs-on: ubuntu-latest  
  needs: [findChangedCsFiles, generatePdfWithCode]  # Uses PDF artifact
  # Downloads PDF and creates unified docs

📁 Files Changed

• .github/workflows/csharp.yml: Updated workflow to use dedicated VM and artifacts
• .scripts/publish-unified-docs.sh: New unified documentation publishing script

🖥️ Self-Hosted Runner Requirements

For optimal performance, self-hosted runners with the pdf-generation label should have:

# LaTeX and dependencies pre-installed
sudo apt-get install -y texlive texlive-lang-cyrillic texlive-latex-extra python-pygments ghostscript

✅ Benefits

• ⚡ Faster CI: PDF generation doesn't block other jobs
• 📖 Better UX: Single documentation entry point
• 🔄 Unified Process: One script handles all documentation types
• 🛡️ Resilient: Works even if PDF generation fails
• 🎯 Maintainable: Scripts versioned with repository

🧪 Testing

The implementation:

• ✅ Maintains backward compatibility
• ✅ Gracefully handles PDF generation failures
• ✅ Creates proper GitHub Pages deployment
• ✅ Follows existing repository patterns

---

🤖 This PR was automatically generated to solve issue #59