fix: prevent docs deployment from being cancelled

[ooples]

Summary

Fixes documentation deployment which has never successfully completed due to multiple issues.

Issues Fixed

1. "No space left on device" error
The Ubuntu runner runs out of disk space while building DocFX docs and Blazor Playground. Added a cleanup step that removes ~20GB+ of pre-installed software we don't need:

• Old .NET versions (6.x, 7.x)
• Android SDK (~14GB)
• GHC (Haskell)
• CodeQL
• Chromium
• PowerShell

2. Job dependency causing cancellation (already fixed but kept the note)
The needs: build-windows dependency was removed so the docs job can run independently in its own concurrency group.

Changes

1. Added "Free up disk space" step that removes unused pre-installed software
2. Removed needs: build-windows dependency from build-docs job
3. Added explanatory comments

After this merge

The next push to master should successfully deploy:

• https://ooples.github.io/AiDotNet/ - Documentation home
• https://ooples.github.io/AiDotNet/api/ - API reference
• https://ooples.github.io/AiDotNet/playground/ - Interactive Blazor Playground

Test plan

• Merge this PR
• Check workflow run shows disk space before/after cleanup
• Verify Build & Deploy Documentation job completes successfully
• Check https://ooples.github.io/AiDotNet/ is accessible

Generated with Claude Code

[coderabbitai]

Summary by CodeRabbit

• Documentation
  • Documentation build and deployment now run independently, improving release cadence and reducing coupling with other platform builds.
• Chores
  • Improved deployment controls and permissions for safer publishing.
  • Added disk cleanup early in the docs workflow to reduce pipeline failures and increase reliability.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

Walkthrough

Decoupled the build-docs job from build-windows, added explicit permissions, concurrency/group "pages" with cancel-in-progress: false, an environment block for github-pages, and a pre-checkout disk cleanup step plus explanatory comments in the .github/workflows/sonarcloud.yml workflow.

Changes

Cohort / File(s)	Summary
CI workflow — sonarcloud .github/workflows/sonarcloud.yml	Removed needs: build-windows for build-docs; added permissions (contents: read, pages: write, id-token: write), concurrency (group: "pages", cancel-in-progress: false), and environment: github-pages; retained deployment steps.
CI workflow — docs prep step .github/workflows/sonarcloud.yml	Introduced preparatory "Free up disk space" step (disk cleanup removing large preinstalled packages) placed before checkout; added explanatory comments clarifying independent docs flow and cleanup rationale.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

• fix: run documentation deployment in parallel with tests #734: Modifies the same .github/workflows/sonarcloud.yml build-docs job to enable independent/parallel docs deployment (permissions, concurrency, job setup).
• ci: fix docs workflow and remove duplicate net471 tests #731: Updates GitHub Actions workflow configurations including documentation-related jobs and CI workflow adjustments.

Poem

🐰 I hopped the workflow fence at dawn, delighted and spry,
Docs freed from Windows—now they soar through the sky.
I cleared a small burrow, made room on the run,
Pages march to deploy under a warm GitHub sun. 🥕✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: preventing docs deployment cancellation by removing the build-windows dependency and adding independent concurrency control.
Description check	✅ Passed	The description is comprehensive and directly related to the changeset, explaining the issues fixed (disk space and job dependency), changes made, and test plan.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/docs-no-cancel

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Copilot]

Pull request overview

This PR fixes an issue where documentation deployment was consistently being cancelled due to workflow concurrency settings. When multiple commits are pushed to master quickly, the workflow's cancel-in-progress: true setting causes newer runs to cancel older ones, preventing the documentation job from completing.

Changes:

• Removed the needs: build-windows dependency from the build-docs job to allow it to run independently
• Added explanatory comments documenting why the job doesn't need to wait for the build-windows job

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.