created: 20131202081424080
creator: JeremyRuston
modified: 20131203093908677
modifier: JeremyRuston
tags: dev
title: TiddlyWiki5 Versioning
type: text/vnd.tiddlywiki

Each release of TiddlyWiki5 is identified by a version number that complies with the [[Semantic Versioning 2.0.0|http://semver.org/]] standard.

! TiddlyWiki Core Version

According to the standard:

```
Given a version number MAJOR.MINOR.PATCH, increment the:

MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.
Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.
```

!! Alpha and Beta versions

While in alpha TiddlyWiki5 uses the pre-release label "alpha", for example:

```
5.0.1-alpha
```

Each new alpha or beta release will bump the `PATCH` version number. This breaks the strict semantics of versioning because `PATCH` increments are supposed to be reserved for compatible changes.

//Note that prior to ''5.0.1-alpha'', TiddlyWiki5 used version numbers formatted as ''5.0.0-alpha.19''. The change was made to enable the upgrade mechanism to recognise plugin updates from the version information.//

!! Interim versions

During development when a new release is being prepared, the pre-release label is set to `prerelease`.

! Plugin Versions

Version numbers

TiddlyWiki5 uses the version information attached to plugins for determining which of two plugins is more recent during an upgrade or import. The pre-release label is ignored when performing these comparisons.