Skip to content

Commit 09958b6

Browse files
committed
docs: document Iniationware versioning strategy and release process
- Add versioning pattern v{YEAR}.{WEEK}-IW.{INCREMENT} - Document release creation workflow - Explain GitHub Actions integration - Provide bash commands for version management
1 parent 505ee32 commit 09958b6

File tree

1 file changed

+41
-1
lines changed

1 file changed

+41
-1
lines changed

CLAUDE.md

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -129,4 +129,44 @@ When dealing with background operations and UI updates:
129129
- Use `Command.Exec()` for fire-and-forget, `Command.ExecAsync()` for awaitable operations
130130
- Parse command output in `ParseResult()` override
131131
- Log all commands through `ICommandLog` interface
132-
- Handle errors gracefully with proper exception handling
132+
- Handle errors gracefully with proper exception handling
133+
134+
## Versioning and Release Strategy
135+
136+
### Iniationware Version Pattern
137+
**Format**: `v{YEAR}.{WEEK}-IW.{INCREMENT}`
138+
- **Base Version**: Always use the latest official SourceGit release tag (e.g., v2025.34)
139+
- **IW Suffix**: Add `-IW.X` to indicate Iniationware custom features
140+
- **Increment**: Increase the number after IW for each new Iniationware release
141+
142+
**Examples**:
143+
- `v2025.34-IW.1` - First Iniationware release based on SourceGit v2025.34
144+
- `v2025.34-IW.5` - Fifth Iniationware release based on same base version
145+
146+
### Creating a New Release
147+
```bash
148+
# 1. Find the latest official SourceGit version (without IW)
149+
git tag --list | grep -v "IW" | grep "v2025" | sort -V | tail -1
150+
151+
# 2. Find the latest IW version for that base
152+
git tag --list | grep "v2025.34-IW" | sort -V | tail -1
153+
154+
# 3. Create new tag with incremented IW number
155+
git tag -a v2025.34-IW.6 -m "Release description..."
156+
157+
# 4. Push tag to trigger GitHub Actions workflow
158+
git push origin v2025.34-IW.6
159+
```
160+
161+
### GitHub Actions Workflow
162+
The `.github/workflows/release.yml` automatically:
163+
1. Triggers on new version tags (v*)
164+
2. Builds the application for all platforms
165+
3. Creates packages (Windows, macOS, Linux)
166+
4. Publishes GitHub release with assets
167+
168+
### Important Notes
169+
- **Stay on base version**: Don't change the base version (e.g., v2025.34) unless updating to newer SourceGit
170+
- **Only increment IW number**: For Iniationware features, only increase the number after -IW
171+
- **Tag triggers workflow**: Pushing a tag automatically starts the release build process
172+
- **Semantic messages**: Use clear, descriptive release notes focusing on added features

0 commit comments

Comments
 (0)