ShareX Workflow and Versioning

Installation
SKILL.md

Scope

This file is the single source of truth for Git and versioning rules that involve:

  • Commit and push workflow
  • Commit message format
  • Version bump behavior
  • Directory.Build.props updates

This supersedes the retired docs/development/RELEASE_PROCESS.md.

Version Source Of Truth

  1. Treat the root Directory.Build.props file as the working XerahS app version source of truth.
  2. Before any versioned XerahS commit, compare the root version with the highest existing XerahS git tag.
  3. If the root version is not strictly greater than the latest tag, bump the root version first so the branch carries the next unreleased version.
  4. Never set version numbers in individual .csproj files.
  5. When bumping version, update every tracked Directory.Build.props in the repository that intentionally carries the XerahS app version so values match.
  6. Derived release metadata files, such as build/windows/chocolatey/xerahs.nuspec, must be synchronized from the root version during release automation.
  7. Tagged releases also generate and smoke-test the Chocolatey .nupkg, so release metadata under build/windows/chocolatey/ must stay automation-friendly.
Related skills
Installs
Repository
sharex/xerahs
GitHub Stars
239
First Seen