@@ -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