GiellaLT

GiellaLT provides an infrastructure for rule-based language technology aimed at minority and indigenous languages, and streamlines building anything from keyboards to speech technology. Read more about Why. See also How to get started, and our Privacy document.

View GiellaLT on GitHub giellalt/giellalt.github.io

Speller release procedure

Speller release step by step

TL;DR Push the tag first, then the branch

We assume you use Tower to do this (TODO: document for other git tools and for using the command line).

  1. Make sure your git version is up to date: commit own changes, pull to last version, push eventual own changes to get a clean version.
  2. Update the speller version number constant SPELLERVERSION in configure.ac, using semantic versioning:
    • MAJOR version = incompatible changes, and going from beta to release (from 0.x.x to 1.x.x)
    • MINOR version = new / more words
    • PATCH version = actual bug fixes
  3. Make sure that the new version is also recorded in manifest.toml, either by editing manually, or (the safer option) by running make after changing configure.ac ( both these files are found in lang-xxx, xxx being the iso code of your language).
  4. Go to Tower and commit the changes to both configure.ac and manifest.toml in one common commit, but do not push yet
  5. create a new GIT tag for the release, as follows::
    1. click on the main branch in Tower (in the left menu). The commit you just made for confiugre.ac and manifest.toml should be on the top of the list.
    2. Right-click on that commit version and choose Create New Tag From.
    3. In the Name field, write the name of the new release, using the following pattern: “speller-” plus language code plus / plusv plus the version string you just committed. If the newly committed version string is 1.2.3 and the language code is fao, you should add the tag speller-fao/v1.2.3
    4. Click on Create Tag. The new wersion will now appear under the Tags speller-xxx menu to the left (where xxx is your iso code)
  6. Click on the usual Push button. Open Options to make sure that Push all tags is chosen, and click Push
  7. Now, the new speller version should be visible in divvun.uit.no within appr. 10 minutes.

Additional comments:

  1. check for non-nightly pushes of the released language in this channel: https://giella.zulipchat.com/#narrow/stream/124606-github/topic/pahkat.2Euit.2Eno-index.20.2F.20main
  2. Only when a non-nightly push of your language appears in the above channel: bump the bugfix number, e.g. from 1.2.3 t0 1.2.4 in both configure.ac and manifest.toml. This is to prepare for the next release (which normally is either a bugfix or a minor release), and will ensure that everyone on the nightly channel receive updates automatically. If the release didn’t go through, then see below on re-release before bumping the bugfix number.

CI + CD will do everything, including releasing the updated speller to the pahkat server, as long as the GIT tag is properly set.

The pahkat client installed as part of Divun Manager will then ensure that the new speller version is automatically installed on user machines on the next server poll.

Re-release on error

If something caused the CI or CD to fail, fix the the issue, and add the same GIT tag to the new revision, the one containing the bug fixes. You will be told there already exists an identical tag, so force push to override the old one.

As long as the new version did not reach users, there is no need to update the version string. But if the buggy version DID get released, then you MUST start from the top, and create a new version. That should be a bugfix version.

Tags, version strings and Divvun Manager channels

Divvun Manager has three channels to install from, selectable from the preferences (the actual text may be localised):

The channels are populated as follows:

Stable

Any keyboard or language model commit that is:

Beta

Any keyboard or language model commit that is:

Nightly/Developer

Any keyboard or language model commit pushed to GitHub. That is, Nightly will always contain the latest successful CI/CD build.

Automatic updates in Divvun Manager

When an update is released, in any of the channels according to the rules above, older packages will be updated automatically from the active channel as long as the version number is higher. The version number comparison does not take into account suffixes like -nightly, so to ensure proper automatic installation, make sure to bump the version number after a regular (beta or stable) release.

Sitemap