4

Version-Standard

Jonathan Miller edited this page 2026-06-21 05:40:12 +00:00

Table of Contents

• Version Numbering Standard
• Format
• Suffixes (release system only)
• Examples
• Version Bump Rules
• Manifest Fields
• CLI Tools

Version Numbering Standard

Format

[prefix]XX.YY.ZZ

Part	Description	Example
Prefix (optional)	Upstream version for forked projects. Stored in manifest <version_prefix>. Never bumped by tools.	1.26.1+moko.
XX	Major version — breaking changes	02
YY	Minor version — feature releases (bumped on dev → main merge)	35
ZZ	Patch version — bug fixes (bumped on fix/patch branch pre-release)	01

Suffixes (release system only)

Suffixes are never in source files. They are appended by the release system at build time:

Suffix	Channel	Branch
-dev	Development	dev, fix/*
-alpha	Alpha	alpha
-beta	Beta	beta
-rc	Release Candidate	rc
(none)*	Stable	main

Examples

Project	Source File	Dev release	Stable Release
MokoSuite	02.35.00	02.35.00-dev	02.35.00
MokoSuite (patch)	02.35.01	02.35.01-dev	02.35.01
MokoGitea	1.26.1+moko.05.05.00	1.26.1+moko.05.05.00-dev	1.26.1+moko.05.05.00
MokoDoliAuth	02.10.00	02.10.00-dev	02.10.00

Version Bump Rules

Action	Bump	Example
Push to dev	Patch	02.35.00 → 02.35.01
Push to fix/*	Patch	02.35.00 → 02.35.01
Merge dev → main	Minor	02.35.xx → 02.36.00
Merge fix/* → main	None (strip suffix)	02.35.01-dev → 02.35.01
Promote to RC	Minor	02.35.xx → 02.36.00-rc

Manifest Fields

The mokocli manifest (.mokogitea/manifest.xml) stores:

• <version>XX.YY.ZZ</version> — the Moko-managed portion only
• <version_prefix>1.26.1+moko.</version_prefix> — optional, for forked projects

CLI Tools

Tool	Purpose
version_read.php	Read current version (prefix-aware)
version_bump.php	Bump version in all source files (prefix-aware)
version_check.php	Verify version consistency across files
version_set_platform.php	Set version + stability across platform files

Pages

• AUTO-CREATE-ORG-PROJECTS
• Branching-Strategy
• CLI-AUTOMATION
• Coding-Standards
• DEPLOY-SCRIPTS
• DOLIBARR-MODULE-IDS
• DRY-RUN-PATTERN
• Documentation-Standards
• File-Header-Standards
• JOOMLA-SYNC
• LEGAL-DOC-GENERATOR-WEB-README
• MONITORING-SCRIPTS
• NEW-SCRIPTS
• QUICKSTART-ORG-PROJECTS
• RELEASE-MANAGEMENT
• Version-Standard
• WIKI-STANDARDS
• WORKFLOW-STANDARDS
• api-maintenance-index
• api-plugin-index
• api-tests-index
• api-tests-sample-index
• automation-README
• automation-branch-version-automation
• automation-repo-cleanup
• client-repos
• features
  • AUTO-BUMP
  • UPDATE-SERVER
  • Update-Server-Migration-Protocol
• operations
  • DEPLOY-SCRIPTS
  • DEPLOY_SCRIPTS
• reference
  • BULK-OPERATIONS
  • RUNNERS
  • VALIDATION
• standards-mokostandards-file-spec
• templates-client-waas
• templates-dolibarr
• templates-generic
• templates-mcp
• unnamed
• workflows-README
• workflows-auto-release
• workflows-branch-protection
• workflows-build-release
• workflows-cascade-dev
• workflows-changelog-management
• workflows-demo-deployment
• workflows-dev-branch-tracking
• workflows-dev-deployment
• workflows-index
• workflows-release-system
• workflows-renovate
• workflows-reusable-workflows
• workflows-rs-deployment
• workflows-secret-scanning
• workflows-shared-workflows
• workflows-standards-compliance
• workflows-static-analysis
• workflows-sub-issue-management
• workflows-update-server
• workflows-workflow-architecture
• workflows
  • Composer-Publishing