This document outlines how we name releases of Alfresco Community Edition and number included artifacts in order to set proper expectations about the state of the release.
Our practice around release numbering tries to balance various competing goals:
The artifacts included in Alfresco Community Edition are included in multiple types of releases:
Instructions for obtaining these releases is on the page Download and Install Alfresco.
The version numbers of individual artifacts roughly follows the semantic versioning scheme.
Alfresco Support needs to be able to tell when someone is using an officially supported version of the product. To meet that need, the patch numbering of the open source releases of Alfresco Community Edition end in a letter which clearly differentiates them from service pack releases of Alfresco Content Services.
Major: Number used to identify major releases in functionality that allow major architectural changes and breaking API changes. Examples 3.0, 4.0, 5.0
Minor: Number used to identify minor releases which contain new features but within the same major version family are expected to preserve API compatibility. Examples: 3.1, 3.2, 3.3
Patch: Builds that are publicly released and advance toward the full feature set targeted for that minor version family. Example 3.4.a, 3.4.b, 3.4.c
As a general rule, Alfresco does not release patches for previous versions of Alfresco Community Edition once development has moved on to develop features for the next minor version.
Alfresco Enterprise Major.Minor.ServicePack.HotFix
Where:
Major: Number used to identify major releases in functionality that allow major architectural changes and breaking API changes. Examples: 3.0, 4.0, 5.0
Minor: Number used to identify minor releases which contain new features, but within the same major version family are expected to preserve API compatibility. Examples: 3.1, 3.2, 3.3
ServicePack: Number to identify the service pack. Service packs contain bug fixes and are not intended to introduce new features. See the Support Handbook for the official policy on what is included in service packs. Examples: 3.3.1, 3.3.2, 3.3.3
HotFix: Number to identify which hot fix is included in a release. See the Support Handbook for the official policy around hot fixes. Examples 3.3.1.115
A monthly release bundle is either an Early Access (EA) release or a Generally Available (GA) release. EA releases are intended to provide access to new features to early adopters, and to foster collaborative development. GA releases are intended to be used by people that are new to the products and don't yet have the background to evaluate release quality for themselves. GA releases are the default download.
In order to receive the "GA" label, a monthly release bundle needs to:
Some Alfresco open source projects will have additional releases separate from the cadence of the monthly release bundles. The monthly release bundles pull the most recent releases that meet the goals for that month's release (EA or GA). In order to maintain stability, a GA release might include components from previous release bundles instead of containing the latest version of every Alfresco open source project. Similarly, some EA releases are often of a very high quality but fail to meet the above criteria. It is important to read the release notes for a monthly release bundle in order to understand the specific state of the release. If you are interested in collaborating around the development of individual open source components contained in the release bundle, it is important to follow that specific project in order to be aware of all the releases.
Ask for and offer help to other Alfresco Content Services Users and members of the Alfresco team.
Related links:
By using this site, you are agreeing to allow us to collect and use cookies as outlined in Alfresco’s Cookie Statement and Terms of Use (and you have a legitimate interest in Alfresco and our products, authorizing us to contact you in such methods). If you are not ok with these terms, please do not use this website.