Release Guides

Cooking release

Cooking is a rolling release, the iso is built after any change in the repo.

Packages : Release Tasks on the wiki

Stable release

A stable release is a snapshot of cooking, tagged, frozen, and built into official ISOs. Follow these steps in order.

1. Prepare release notes

Write release notes for the new version and add them to the website under {lang}/doc/releases/{version}/. Cover: new features, package updates, known issues, upgrade instructions.

2. Tag the wok and copy to wok-stable

Tag the cooking wok at the release point, then copy it to wok-stable: 

$ cd wok
$ hg tag <version>
$ hg push
$ cd ..
$ cp -a wok wok-stable   # or sync via your preferred method

3. Freeze packages: cooking/ to stable/

Copy the validated package set from the cooking mirror to the stable mirror: 

$ cd /path/to/mirror
$ cp -a cooking/ stable/

Only copy packages that have been tested. Do not include broken or in-progress packages.

4. Verify the version in wok-stable

Check that /etc/slitaz-release in the slitaz-base-files package matches the release version: 

$ grep -r slitaz-release wok-stable/slitaz-base-files/

Update the file if needed, rebuild the package, and push.

5. Generate ISOs

Build the stable ISOs on the build host (tank) from the frozen wok-stable and stable packages. See the Build Host cookbook for full instructions.

6. Update the website and download links

Update config.php at the root of the website — it is the single source of truth for version numbers and mirror URLs: 

$ vi config.php   # update $version, $iso_url, mirror paths

Then publish news and update the download pages. Announce on the forum and mailing list.

Project release

SliTaz sub projects are individually released using the SliTaz developers tool aka 'tazdev'. Here is a handy cmdline guide to release a project. In this guide we are going to release 'spk' 1.0: 

$ cd spk
$ hg pull -u
$ hg tag 1.0
$ hg push
$ tazdev -rp spk

Some packages don't need to be archived on the mirror since they are mirrored in the full packages tree. Once that you have released the package and said yes to updating the wok (or done it manually), you can push it to hg.slitaz.org and wait for the package to build on the SliTaz packages Cooker. Push to Hg: 

$ cd ../wok
$ hg push