View on GitHub

FreeCAD Developers Handbook

A handbook about FreeCAD development

Release Process #

This page describes a high-level overview of the release planning and management process.

We recognize signficant wisdom in the philosophy to “Release Early and Release Often”. However, releases can require significant coordinated work within the community. FreeCAD aspires to produce a major release every 3-6 months. In order to meet this goal, we will work to make releases more predicatable and automated.

Major and Minor Releases #

A major release introduces new features and introduces key improvements. Major releases may also introduce breaking changes that invalidate documentation or change existing APIs. They may also deprecate older functionality.

Between major releases, bugs are occasionally found and repaired. These fixes may be urgent enough or isolated enough that applying them incrementally to the existing ‘stable’ version is both possible and desirable. A set of such changes may be grouped together and released as a ‘minor’ version.

Major and minor releases have slightly different processes.