Update troubleshooting section for disk space issues

[davidmfinol]

Changes

• Clarified disk space issues when running multiple jobs sequentially in GitHub Actions workflows. Updated recommendations for using GitHub-hosted larger runners and self-hosted/cloud runners.

Checklist

• Read the contribution guide and accept the
  code of conduct
• Readme (updated or not needed)
• Tests (added, updated or not needed)

Summary by CodeRabbit

• Documentation
  • Enhanced troubleshooting guidance for disk-space issues on GitHub Actions, clarifying limited disk on hosted runners and how sequential jobs can exhaust space
  • Added "GitHub-Hosted Larger Runners" as a remediation option with link
  • Expanded self-hosted and cloud runner guidance, including clearer examples and updated remediation steps (cloud runner example added)

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

[github-actions]

[coderabbitai]

Walkthrough

Documentation for troubleshooting GitHub Actions disk-space issues was expanded: added explicit rationale about limited GitHub-hosted runner disk space and large Unity images, described disk-space risks when jobs run sequentially, introduced a new “GitHub-Hosted Larger Runners” remediation, and expanded the self-hosted/cloud runners guidance with examples.

Changes

Cohort / File(s)	Change Summary
Documentation expansion & reorganization docs/09-troubleshooting/common-issues.mdx	Expanded disk-space guidance with GitHub-hosted runner limits and Unity image size; added sequential-job disk-space risk examples; added “GitHub-Hosted Larger Runners” remediation step; renumbered and expanded “Use Self-Hosted or Cloud Runners” with cloud runner examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Single documentation file changed with straightforward content additions and reorganization
• No code or configuration logic modified

Poem

🐇 I nibble bytes where runners sleep,

I tidy caches, make builds less steep.
New runner choices bloom and sing,
Disk-space troubles take to wing.
Hooray for clearer paths we bring! ✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely summarizes the main change in the changeset: updating troubleshooting documentation for disk space issues.
Description check	✅ Passed	The pull request description includes all required sections with appropriate detail: a clear Changes section describing the modifications and a completed Checklist confirming contribution guidelines compliance.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch davidmfinol-patch-4

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 030a146 and d3b2e64.

📒 Files selected for processing (1)

• docs/09-troubleshooting/common-issues.mdx (2 hunks)

🚧 Files skipped from review as they are similar to previous changes (1)

• docs/09-troubleshooting/common-issues.mdx

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: build_and_preview

---

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.}

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1e49e41 and 030a146.

📒 Files selected for processing (1)

• docs/09-troubleshooting/common-issues.mdx (2 hunks)

🧰 Additional context used

🪛 GitHub Actions: 👩‍💻

docs/09-troubleshooting/common-issues.mdx

[error] 1-1: Prettier formatting check failed for docs/09-troubleshooting/common-issues.mdx. Run 'prettier --write' to fix code style issues.

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: build_and_preview

🔇 Additional comments (1)

docs/09-troubleshooting/common-issues.mdx (1)

282-292: Links verified and accessible.

Both external documentation references are accessible:

• GitHub-Hosted Larger Runners documentation returns HTTP 200 (direct access)
• game.ci Cloud Runners documentation returns HTTP 301 (permanent redirect, properly handled by browsers/clients)

The content is well-structured, actionable, and correctly references current external documentation. No issues identified.

[github-actions]

Visit the preview URL for this PR (updated for commit d3b2e64):

https://game-ci-5559f--pr524-davidmfinol-patch-4-9o1bv1mv.web.app

_{(expires Sat, 29 Nov 2025 18:04:57 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 1f0574f15f83e11bfc148eae8646486a6d0e078b}