Asqatasun v4 - Summary

Asqatasun v4 - Release a stable version of Asqatasun

This is the documentation for releasing a new stable version for Asqatasun. As an end user, you won't need it, it is just for developers.

1) Prepare CHANGELOG.md:

2) Update all READMEs

2b) Update Upgrade instructions

3) Upgrade version strings in code with bump_asqatasun.sh

./engine/asqatasun-resources/src/main/resources/release/bump_asqatasun.sh \
    --from-version X.Y.Z-SNAPSHOT \
    --to-version X.Y.Z \
    --branch MY-RELEASE-BRANCH \
    --source-dir . \
    --commit \
    --tag

(We don't push yet, do the testing stuff before :) )

4) Build local Docker image with locally build Asqatasun

When --source is specified, get into that source directory and:

./docker/build_and_run-with-docker.sh -l -s "${PWD}" -d docker/SNAPSHOT-local --skip-build-test

Else when using clone in /tmp:

cd /tmp/Asqatasun   # Directory used to clone Github repos
./docker/build_and_run-with-docker.sh -l -s /tmp/Asqatasun -d docker/SNAPSHOT-local --skip-build-test

5) Push branch and new X.Y.Z tag

git push origin MY-RELEASE-BRANCH
git push origin vX.Y.Z

6) Switch back release strings to "-SNAPSHOT"

From the top of Asqatasun source directory, do:

./engine/asqatasun-resources/src/main/resources/release/bump_asqatasun.sh \
    --from-version X.Y.Z \
    --to-version A.B.C-SNAPSHOT \
    --branch MY-RELEASE-BRANCH \
    --source-dir . \
    --commit \
    --push \
    --back-to-snapshot

7) In Github:

8) Update Download.asqatasun.org

...so that "latest" points to the last release.

9) In Github, define this tag as "Release"

(as this one is the actual Release and not a pre-release)

10) In Asqatasun Docker hub

11) Launch prepared announces:

11) Update W3C ERT list

... on https://www.w3.org/WAI/ER/tools/index.html

11) Celebrate and have a beer !