System Documentation¶
Infrastructure, CI/CD, release automation, and dependency management for the Zer0-Mistakes Jekyll theme.
Contents¶
| Document | Description |
|---|---|
| Release Automation | Canonical 10-step release workflow via scripts/bin/release |
| Automated Version System | Conventional-commit analysis and semantic version bumping |
| Gem Publication System | Building and publishing to RubyGems.org |
| Implementation Summary | What the automation system does and how it was built |
| CI/CD Status Report | GitHub Actions pipeline: stages, matrix, and current status |
| Dependency Management | Zero Pin + Lockfile + weekly automated update strategy |
| Ruby Version Management | Why Ruby 3.3, upgrade path, CI matrix |
| GitHub Secrets Setup | Required GitHub Actions secrets (Docker Hub, RubyGems) |
| Zero Pin Strategy | Rationale for unpinned Gemfile with committed lockfile |
Quick Reference¶
# Release (patch / minor / major)
./scripts/bin/release patch
./scripts/bin/release patch --dry-run # preview
# Troubleshoot
docs/development/troubleshooting.md
# Dependency updates
bundle update && bundle exec jekyll build