Skip to content

docs: add troubleshooting section to README#116

Merged
sebrandon1 merged 1 commit into
mainfrom
docs/troubleshooting
Jul 17, 2026
Merged

docs: add troubleshooting section to README#116
sebrandon1 merged 1 commit into
mainfrom
docs/troubleshooting

Conversation

@sebrandon1

Copy link
Copy Markdown
Contributor

Summary

  • Add Troubleshooting section to README covering common failure modes:
    • OOM kills — swap, memory allocation, bundle caching
    • Disk space exhaustion — cleanup, storage relocation, disk report step
    • CRC start failures — retry behavior, transient errors
    • Operator timeouts — configurable timeout, selective operator checks
    • Connectivity failures — Red Hat status, non-fatal GitHub API check

Closes #81

Document common failure modes and mitigations: OOM kills, disk space
exhaustion, CRC start failures, operator timeouts, and connectivity
failures. Points users to the existing disk report step and Red Hat
status page.

Closes #81
@sebrandon1
sebrandon1 force-pushed the docs/troubleshooting branch from 740c271 to e4ae186 Compare July 17, 2026 17:49
@sebrandon1
sebrandon1 merged commit 8c35972 into main Jul 17, 2026
1 check passed
@sebrandon1
sebrandon1 deleted the docs/troubleshooting branch July 17, 2026 17:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add troubleshooting section to README

1 participant