1

Memo commit / tag / release

Alban Dumerain edited this page 2026-01-22 14:59:56 +01:00

Table of Contents

• 🧠 Mémo procédure Release — Paycheck (commit / tag / release)
• 📌 Règles obligatoires
• 1️⃣ Commit (français)
• Étapes
• Exemples
• 2️⃣ Tag (français)
• Création du tag annoté
• Exemple
• Push
• 3️⃣ Notes de release (Markdown — prêt Gitea)
• Modèle officiel Paycheck
• 🐷 Paycheck vX.Y.Z — Titre de la release
• 🛠️ Corrections
• ✅ Impact
• ℹ️ Notes
• 🧭 Versioning
• 4️⃣ Checklist post-release (rapide)
• 🐧 Debian stable (Trixie)
• 🪟 Windows
• 5️⃣ Checklist finale avant publication
• 🧩 Philosophie

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

🧠 Mémo procédure Release — Paycheck (commit / tag / release)

Ce mémo décrit la procédure officielle pour publier une nouvelle version de Paycheck. Il sert de référence unique pour les releases futures (v1.x).

---

📌 Règles obligatoires

• 📝 Commit en français
• 🏷️ Tag en français
• 📣 Notes de release en Markdown, prêtes à coller dans Gitea
• 🎯 Une release correspond toujours à un tag Git vX.Y.Z
• 🔒 La release est faite depuis un dépôt propre et taggé

---

1️⃣ Commit (français)

Étapes

1. Vérifier l’état du dépôt : git status

2. Ajouter les fichiers : git add .

3. Commit avec un message clair en français : git commit -m "Description claire et concise de la modification"

Exemples

• "Correction du module Go et des imports après renommage en Paycheck"
• "Amélioration de l’export PDF Windows"
• "Nettoyage de la structure frontend"

---

2️⃣ Tag (français)

Création du tag annoté

git tag -a vX.Y.Z -m "vX.Y.Z - Description courte en français"

Exemple

git tag -a v1.0.1 -m "v1.0.1 - Correction du module Go et des imports"

Push

git push origin main git push origin vX.Y.Z

---

3️⃣ Notes de release (Markdown — prêt Gitea)

Modèle officiel Paycheck

À copier-coller tel quel dans Gitea :

---

🐷 Paycheck vX.Y.Z — Titre de la release

Phrase courte décrivant l’objectif principal de la version.

---

🛠️ Corrections

• Correction ou amélioration n°1
• Correction ou amélioration n°2
• Correction ou amélioration n°3

---

✅ Impact

• Effet concret côté build / stabilité / maintenance
• Aucun changement fonctionnel côté utilisateur (si applicable)

---

ℹ️ Notes

• Informations complémentaires utiles
• Contexte technique si nécessaire

---

🧭 Versioning

Cette version est :

• soit un correctif (v1.0.x)
• soit une amélioration (v1.x)
• soit une évolution majeure (v2.0)

---

4️⃣ Checklist post-release (rapide)

🐧 Debian stable (Trixie)

1. Se positionner sur le tag : git fetch --tags git checkout vX.Y.Z

2. Vérifier le tag : git describe --tags --exact-match

3. Lancer l’application : wails dev -tags webkit2_41

---

🪟 Windows

1. Se positionner sur le tag : git fetch --tags git checkout vX.Y.Z

2. Build Windows : wails build -platform windows/amd64

---

5️⃣ Checklist finale avant publication

• Dépôt propre (git status OK)
• Tag vX.Y.Z présent et poussé
• Build effectué depuis le tag
• Binaires nommés correctement :
  • paycheck-vX.Y.Z-linux-amd64.zip
  • paycheck-vX.Y.Z-windows-amd64.zip
• Notes de release rédigées en français

---

🧩 Philosophie

• Simplicité
• Lisibilité
• Traçabilité
• Zéro ambiguïté entre versions et machines

Ce mémo est la référence pour toutes les releases Paycheck à partir de la v1.0.1.