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 README.md (THE readme from top directory):

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 \
    --automerge \
    --commit \
    --tag

do not use the --push option

(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 master branch and new X.Y.Z tag

git push origin master
git push origin vX.Y.Z

6) For develop branch, 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 \
    --source-dir . \
    --back-to-snapshot \
    --commit
git push origin develop

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 !