From 8d0f3bfe2c3312f50976a0557b47f2d9e0e333c8 Mon Sep 17 00:00:00 2001
From: David Larlet <david@larlet.fr>
Date: Fri, 25 Aug 2023 09:46:26 -0400
Subject: [PATCH] Documentation for the release process

---
 RELEASE.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 RELEASE.md

diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 00000000..6fb3320f
--- /dev/null
+++ b/RELEASE.md
@@ -0,0 +1,27 @@
+# How to make a release
+
+1. I18N
+    - `make messages` look for new strings within the code
+    - `make tx_push` to publish new strings [to transifex](https://app.transifex.com/openstreetmap/umap/dashboard/)
+    - 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
+2. Bump version: `make patch|minor`
+3. `git commit -am "1.X.Y"`
+4. `git tag 1.X.Y`
+5. `git push && git push --tag`
+6. Go to [Github release page](https://github.com/umap-project/umap/releases/new) and Generate release notes + paste it in `docs/changelog.md` + finish Github process for a new release
+7. `make build`
+8. `make publish`
+9. `make docker`
+
+## Deploying instances
+
+### OSMfr
+
+Makefile on @yohanboniface computer. TODO: share it :)
+
+### ANCT
+
+Update the [Dockerfile](https://gitlab.com/incubateur-territoires/startups/donnees-et-territoires/umap-dsfr-moncomptepro/-/blob/main/Dockerfile?ref_type=heads) with correct version.