Criando lançamento do Weblate

Release cycle

Weblate uses calendar versioning with monthly releases. The version format is <YEAR>.<MONTH>.<PATCH> with a numeric, non-zero-padded month. The <PATCH> part is omitted for the first release in a month when it would be 0, for example 2026.5. Patch releases use the full version number, for example 2026.5.1.

Monthly releases are usually published at the beginning of the month. Patch releases include bug fixes, security fixes, and dependency updates which should not wait for the next monthly release.

Direct upgrades are supported from releases in the current or previous calendar year. The first release in a new year drops direct upgrade support for releases from the year before the previous year.

The Docker container includes an additional version component to track changes in the container itself, such as dependencies. Fixed Docker image tags include the patch component together with this build component, even when the Weblate version omits a 0 patch component. These updates may include security updates.

Ver também

Planejamento de lançamento

Os recursos para os próximos lançamentos são coletados usando marcos do GitHub, você pode ver nosso roteiro em <https://github.com/WeblateOrg/weblate/milestones>.

Processo de lançamento

Coisas para verificar antes de fazer um lançamento:

  1. Check newly translated languages by ./scripts/list-translated-languages.py.

  2. Definir a versão final usando ./scripts/prepare-release.

  3. Certificar-se de que as capturas de tela estejam atualizadas usando make -j 12 -C docs update-screenshots.

  4. Junte todas as traduções pendentes usando wlc push; git remote update; git merge origin/weblate

When building distribution packages locally, start from a clean checkout or remove ignored packaging artifacts such as build/, dist/, weblate.egg-info/, and generated weblate/locale/**/*.mo files.

Fazer o lançamento:

  1. Criar um lançamento usando ./scripts/create-release --tag (veja abaixo os requisitos).

Etapas manuais pós-lançamento:

  1. Fechar o marco do GitHub.

  2. Assim que a imagem Docker for testada, adicionar uma tag e fazer o push dela.

  3. Incluir a nova versão em .github/workflows/migrations.yml para cobri-la nos testes de migração.

  4. Incrementar a versão no repositório usando ./scripts/set-version.py.

  5. Verificar se o readthedocs.org compilou todas as traduções da documentação usando ./scripts/rtd-projects.py.

Para criar tags usando o script ./scripts/create-release, você precisará do seguinte:

  • Acesso por push a repositórios git Weblate (ele envia tags)