64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# Error Handling
|
|
|
|
## Common Issues
|
|
|
|
### GitHub CLI not authenticated
|
|
|
|
**Detect**: `gh auth status` fails
|
|
|
|
**Solution**:
|
|
```bash
|
|
gh auth login
|
|
# Follow prompts to authenticate
|
|
```
|
|
|
|
### Repository name conflicts
|
|
|
|
**Detect**: API error for existing repo
|
|
|
|
**Solution**:
|
|
- Check availability: `gh repo view <owner>/<name>`
|
|
- Suggest alternative names
|
|
- Offer to use different organization
|
|
|
|
### Insufficient permissions
|
|
|
|
**Detect**: 403 errors from API
|
|
|
|
**Solution**:
|
|
- Verify organization membership
|
|
- Check repository permissions
|
|
- Contact organization admin for elevated access
|
|
|
|
### Missing git configuration
|
|
|
|
**Detect**: `git config` returns empty
|
|
|
|
**Solution**:
|
|
```bash
|
|
git config --global user.name "Your Name"
|
|
git config --global user.email "your@email.com"
|
|
```
|
|
|
|
### Rate limiting
|
|
|
|
**Detect**: 429 errors from API
|
|
|
|
**Solution**:
|
|
- Wait for rate limit reset
|
|
- Check limit: `gh api /rate_limit`
|
|
- Retry with exponential backoff
|
|
|
|
## Success Criteria
|
|
|
|
- [ ] Repository created with appropriate visibility
|
|
- [ ] Security features enabled (Dependabot, secret scanning)
|
|
- [ ] Complete documentation (README, LICENSE, community files)
|
|
- [ ] CI/CD workflows configured and functional
|
|
- [ ] Issue and PR templates set up
|
|
- [ ] Branch protection rules active (enterprise/team modes)
|
|
- [ ] CODEOWNERS configured (team mode)
|
|
- [ ] Repository accessible and cloneable
|
|
- [ ] Validation checks pass
|
|
- [ ] User has clear next steps
|