The aim of this page is to gather ideas and organize things so official releases of FreeCAD require less work, and therefore can happen more often. This topic is discussed on this forum thread.

General ideas

• The "target release" field of the tracker should be used more, even on bugs that are not assigned to anybody, to mark bugs that we find important to solve before a release, or features we are working on, so others are aware of "how close" we are to release. This appears on the roadmap.
• We should find a way to process the list below (A "tickable" list somewhere?)

Planning

• Ideally official releases should happen each 3 to 6 months
• A signal should be emitted (by jriegel?) before the release (3 weeks?) so:
  • No more new feature gets introduced, only bug fixes
  • The strings are collected and uploaded to crowdin for translation
  • The documentation can be fully updated
  • The release notes can be prepared/finished

Release management

Preparing FreeCAD for a release

Release Day - 3 weeks - Feature Freeze

1. Forum post announcing the feature freeze and asking for testing
2. Start changing the version number in the FreeCAD docs
3. Announce to all Workbench maintainers on FreeCAD-Addons know to prepare
4. Announce to all Macro creators on FreeCAD-Macros know to prepare
5. Asking wiki editors/translators to prepare for upcoming release.

Release Day - 2 weeks - String Freeze

1. Update and commit new .ts files
2. Push translation files to Crowdin, use Crowdin Scripts
3. Send a message to all FreeCAD translators about the deadline of the upcoming release -- set the deadline for delivering the translations to e.g. "Release Day -3 day"
   • To message all translators on Crowdin: Log in to Crowdin and make an announcement (TODO: add link here)

Release Day - 1 week

1. Send the final version of the (short) release announcement to all translators, asking them to translate it into their languages -- set the deadline for delivering the translations to e.g. "Release Day -1 day"

Release Day - 3 days

1. Finish the release notes
2. Finish PR spiel for the forum and wiki/website.
3. Announce to all FC translators (see Release t-2 weeks) that the deadline for their translations is about to pass

Release Day - 2 days

• Update years in source files
• Update the python API doc pages - yorik

Release Day - 1 day

• Commit a new splash and about screen image, and update all versions in a number of source code locations:

• README.md
• appveyor.yml
• CMakeLists.txt
• src/Tools/offlinedoc/buildqhelp.py
• src/XDGData/org.freecadweb.FreeCAD.appdata.xml
• vagrant/Xenial/generate_yaml.sh
• vagrant/Xenial/bin/launcher
• vagrant/generate_yaml.sh
• vagrant/FreeCAD.sh

• Prepare a packager's release files and alert the packagers.

• Tag the new release

• TODO: relevant git commands

Release Day

Pre Release

Translations

1. Pull Translations from Crowdin using the Crowdin Scripts (which will pull all Crowdin maintained languages)

Post Release

1. Update and/or check the current version in the wiki:

   Template:Stable-Version (Not up-to-date and no longer used)

   Template:Development-Version (Not up-to-date and no longer used)

   Installing on Windows

   Installing on Linux

   Installing on Mac

   AppImage

   Download

   Where else?

2. Release announcement to the forum
3. Unleash the translators, asking them to send their translated release announcements to local media
4. Update external locations that feature FreeCAD
   • Freshcode (could be automated if we set up Github correctly)
   • Check sourceforge
   • Check repology and track distros that haven't updated to the latest stable

After Specific releases

1. Things that have to be done / updated after a specific release (remove them as soon as they're done)

Tasks

NOTE: These need to be integrated in to the above

These are the tasks required for each release, with the name of the person responsible for it. Add your name if you want to take care of a task!

• Giving the signal to the release (3 weeks before?)
• Gathering the strings to translate and uploading them on crowdin via Crowdin Scripts - yorik
• Announce on the forum and on social networks that translation is needed (this needs to be done several times) - yorik
• Set the splashscreen - yorik
• Unassigned - Update dependencies in README
• Unassigned - Change the version number in the FreeCAD code
• Unassigned - Check that all workbenches pages on the wiki are up-to-date (all their commands are listed), list missing pages
• Unassigned - Manage the updates of the wiki
• Unassigned - Manage the release notes (ex. Release_notes_0.xx)
• Unassigned - Update ChangeLog.txt (we refer people to mantisbt changelog)
• Merge back the translations from crowdin - yorik
• Unassigned - Check the german translation
• Unassigned - Check the french translation
• Unassigned - Check the other translations that have reached 100% (add them here)
• Unassigned - Tag the exact release commit in git
• Unassigned - Make the Windows 32bit build
• Unassigned - Make the Windows 64bit build
• Unassigned - Make the MacOS build
• Unassigned - Make the Ubuntu stable build
• Unassigned - Make the appImage build
• Unassigned - Make the flatpak build
• Unassigned - Make the snap build
• Unassigned - Check the Windows 32bit build
• Unassigned - Check the Windows 64bit build
• Unassigned - Check the MacOS build
• Unassigned - Check the Ubuntu build
• Unassigned - Check the appImage build
• Unassigned - Check the flatpak build
• Unassigned - Check the snap build
• Unassigned - Communicate the release to package managers of linux distributions (debian, fedora, arch)
• Unassigned - Communicate the release to package managers of MacOS (homebrew, macports, fink)
• Unassigned - Communicate the release to package managers of Windows (chocolatey)
• Update the release numbers on the tracker - yorik
• Update the release numbers and download locations on the main web page for all languages - yorik
• Unassigned - Official release announcement on the FreeCAD web page
• Unassigned - Spread it around. see chapter Publicity
• Unassigned - Update the example splash for all *.appdata.xml (ex. FreeCAD/package/fedora/freecad.appdata.xml)
• Try to bump all 3rd party deps to the minimum version to build FreeCAD in the package ecosystem via https://github.com/luzpaz/FreeCAD-dependencies

Publicity

This is a raw list of sites and blogs that have at some point mentioned FreeCAD. It is mostly harvested from http://forum.freecadweb.org/viewtopic.php?f=8&t=143 (until June 29th 2014). Feel free to add more pages or assign one or more pages to yourself to take care of notifying them about a new release of FreeCAD.