Create comprehensive tutorials and user guides for common workflows
and core concepts.
New tutorials:
- tutorials/ci-cd-integration.md (8KB) - Complete CI/CD guide
- GitHub Actions, GitLab CI, and Jenkins examples
- Certificate management and kubeseal CLI usage
- Bulk secret creation and environment-specific patterns
- Troubleshooting and best practices
New user guides:
- user-guide/scopes-explained.md (12KB) - Deep dive into scopes
- Detailed explanation of strict/namespace-wide/cluster-wide
- Security implications and use cases
- Decision tree for scope selection
- Common mistakes and how to avoid them
- Scope comparison table
- user-guide/rbac-permissions.md (10KB) - RBAC configuration
- Required permissions for different access levels
- Example RBAC configurations (viewer, creator, admin)
- Service account setup for CI/CD
- Plugin UI behavior based on permissions
- Troubleshooting permission issues
- Security best practices
Benefits:
- Real-world examples for GitHub Actions, GitLab CI, Jenkins
- Clear security guidance with decision trees
- Copy-paste RBAC manifests for common scenarios
- Troubleshooting sections for each guide
- Cross-referenced with other documentation
Phase 3 deliverables (3-4 days estimated, completed in 1 session):
✅ CI/CD integration tutorial with 3 platform examples
✅ Scopes explained with security best practices
✅ RBAC permissions guide with example manifests
✅ Decision trees and comparison tables
✅ Troubleshooting sections for each guide
Total documentation:
- 30KB of new tutorial/guide content
- 3 comprehensive guides
- 20+ code examples
- Cross-referenced with API docs and other guides
Next: Phase 4 - Troubleshooting guides and ADRs
Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Chris Farhood
282025ca24