Moko Consulting

Open-source software for Joomla, Gitea, and web platforms. Home of MokoSuite, MokoGitea, and MokoCLI.

Tennessee
https://mokoconsulting.tech
Repositories
57
 Projects Packages Code Wiki Members
1
Repositories
57
 Projects Packages Code Wiki Members
1
standards/Version-Standard.-

Version Standard

Semantic Versioning

All repositories follow SemVer 2.0: MAJOR.MINOR.PATCH

  • MAJOR: Breaking changes or significant architectural shifts
  • MINOR: New features, backward-compatible
  • PATCH: Bug fixes, backward-compatible

Version Storage

  • Version is stored in repo metadata via the Gitea API (metadata.version)
  • The metadata is the single source of truth
  • composer.json must NOT contain a version field (Packagist derives from tags)

Stream Tags

Tag Points To Purpose
stable Latest release on main Production-ready
development Latest commit on dev Active development
release-candidate Latest commit on rc Pre-release testing

Stream tags are moved (force-updated) on each release, not created new.

Version Suffixes

Suffixes like -dev, -alpha, -beta, -rc are NEVER stored in source files. They are appended at build time only.

Auto-Bump Workflow

  • pre-release.yml bumps the patch version on pushes to dev and rc
  • [skip bump] in commit messages prevents auto-bump AND pre-release
  • [skip ci] skips ALL workflows including PR checks — use sparingly

Revision History

Date Author Changes
2026-06-21 jmiller Initial consolidation; added stream tags and suffix policy
Pages