almet/umap

mirror of https://github.com/umap-project/umap.git synced 2025-04-28 19:42:36 +02:00

docs: Major version in case of server change(s)

2024-07-12 12:08:05 -04:00

Releases

!!! info "Changelog"

This document describes how we release uMap.

If you are looking for the releases changelog, [please go there](changelog.md).

How to make a release

Make sure JS packages are up to date:
- `make installjs vendors``
Run tests:
- make test
I18N
- make messages look for new strings within the code
- make tx_push to publish new strings to transifex
- translators at work
- make tx_pull to retrieve new translations from transifex
- make compilemessages to create regular .mo + umap/static/umap/locale/*.js
- commit new translations git commit -am "i18n"
Test collectstatic: umap collectstatic --no-input
Bump version: make patch|minor
git commit -am "2.X.Y"
git tag 2.X.Y
git push && git push --tag
Go to Github release page and Generate release notes + paste it in docs/changelog.md + finish Github process for a new release
Commit the changelog git commit -am "changelog"
make build
make publish
make docker

We use a custom flat Makefile, versioned here.

To deploy a new version on the dev server:

To deploy a new version on OSM France servers:

Update the Dockerfile with correct version and put a tag YYYY.MM.DD in order to deploy it to production.

We aim to support Baseline “Widely available” (implemented in major browsers within the last 30 months).

If it's not a major nor a patch, it's a minor.