Delete .github/commit-convention.md
This commit is contained in:
@@ -1,116 +0,0 @@
|
|||||||
# Conventional Commits for bootc Image Template
|
|
||||||
|
|
||||||
This repository follows [Conventional Commits v1.0.0](https://www.conventionalcommits.org/en/v1.0.0/) specification.
|
|
||||||
|
|
||||||
## Commit Message Format
|
|
||||||
|
|
||||||
```
|
|
||||||
<type>(<scope>): <subject>
|
|
||||||
|
|
||||||
[optional body]
|
|
||||||
|
|
||||||
[optional footer(s)]
|
|
||||||
```
|
|
||||||
|
|
||||||
## Types
|
|
||||||
|
|
||||||
Use these commit types for changes to this bootc image template:
|
|
||||||
|
|
||||||
- **build**: Changes to the image build process (Containerfile, build.sh)
|
|
||||||
- **ci**: Changes to GitHub Actions workflows
|
|
||||||
- **config**: Changes to disk image configurations (TOML files)
|
|
||||||
- **feat**: New features or packages added to the image
|
|
||||||
- **fix**: Bug fixes or corrections
|
|
||||||
- **docs**: Documentation changes only
|
|
||||||
- **chore**: Maintenance tasks (dependencies, metadata)
|
|
||||||
- **refactor**: Code restructuring without changing behavior
|
|
||||||
|
|
||||||
## Scopes
|
|
||||||
|
|
||||||
Use these scopes to indicate what part of the image is affected:
|
|
||||||
|
|
||||||
- **base**: Base image changes (FROM line in Containerfile)
|
|
||||||
- **packages**: Package installation/removal
|
|
||||||
- **services**: Systemd service configuration
|
|
||||||
- **disk**: Disk image configuration (ISO, QCOW2, RAW)
|
|
||||||
- **workflow**: GitHub Actions workflows
|
|
||||||
- **metadata**: Image metadata and branding
|
|
||||||
- **signing**: Cosign key and signing configuration
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
### Adding Packages
|
|
||||||
```
|
|
||||||
feat(packages): add development tools and editors
|
|
||||||
|
|
||||||
- Install neovim, git, and htop
|
|
||||||
- Add Development Tools group
|
|
||||||
```
|
|
||||||
|
|
||||||
### Changing Base Image
|
|
||||||
```
|
|
||||||
build(base): switch from Bazzite to Bluefin
|
|
||||||
|
|
||||||
Changing to Bluefin for better developer tooling support
|
|
||||||
```
|
|
||||||
|
|
||||||
### Configuring Services
|
|
||||||
```
|
|
||||||
feat(services): enable SSH and container services
|
|
||||||
|
|
||||||
- Enable sshd.service for remote access
|
|
||||||
- Enable podman.socket for rootless containers
|
|
||||||
```
|
|
||||||
|
|
||||||
### ISO Configuration
|
|
||||||
```
|
|
||||||
config(disk): update ISO to use custom registry
|
|
||||||
|
|
||||||
Update bootc switch URL to point to ghcr.io/username/repo
|
|
||||||
```
|
|
||||||
|
|
||||||
### Workflow Changes
|
|
||||||
```
|
|
||||||
ci(workflow): enable automatic ISO builds
|
|
||||||
|
|
||||||
Configure build-disk.yml to trigger on main branch pushes
|
|
||||||
```
|
|
||||||
|
|
||||||
### Metadata Updates
|
|
||||||
```
|
|
||||||
chore(metadata): update image description and keywords
|
|
||||||
|
|
||||||
Update ArtifactHub metadata with project-specific information
|
|
||||||
```
|
|
||||||
|
|
||||||
### Documentation
|
|
||||||
```
|
|
||||||
docs: add installation instructions for new features
|
|
||||||
```
|
|
||||||
|
|
||||||
### Bug Fixes
|
|
||||||
```
|
|
||||||
fix(packages): disable COPR after package installation
|
|
||||||
|
|
||||||
Ensure COPR repositories don't persist in final image
|
|
||||||
```
|
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
If a change is breaking (e.g., removing packages, changing base image significantly), add `!` after the type/scope:
|
|
||||||
|
|
||||||
```
|
|
||||||
build(base)!: migrate from Fedora 40 to Fedora 41
|
|
||||||
|
|
||||||
BREAKING CHANGE: This upgrade requires a clean reinstall for existing users.
|
|
||||||
```
|
|
||||||
|
|
||||||
## Tips
|
|
||||||
|
|
||||||
- Keep subject line under 50 characters
|
|
||||||
- Use imperative mood ("add" not "added" or "adds")
|
|
||||||
- Don't end subject line with a period
|
|
||||||
- Separate subject from body with a blank line
|
|
||||||
- Use body to explain *what* and *why*, not *how*
|
|
||||||
- Be short and concise, avoid long commit messages, keep it simple
|
|
||||||
- Reference issues/PRs in footer when applicable
|
|
||||||
Reference in New Issue
Block a user