diff --git a/docs/project/RELEASE_PLAN.md b/docs/project/RELEASE_PLAN.md index d886b8b..10bbce2 100644 --- a/docs/project/RELEASE_PLAN.md +++ b/docs/project/RELEASE_PLAN.md @@ -16,6 +16,23 @@ - Tagging: `vX.Y.Z` ou `vX.Y.Z-wip.N` - Notes de release (résumé, changements majeurs, impacts) +### Stratégies de merge (tags → branches cibles) + +- Tag sur `main` (latest): + - Aligner `TEMPLATE_VERSION` et `CHANGELOG.md` sur la branche de travail + - Taguer `vX.Y.Z` puis merger la branche (PR) vers `main` + - Si flux local (CI désactivée): appliquer les agents en local avant tag/push + +- Tag sur `develop` (pré‑release/wip): + - Utiliser `vX.Y.Z-wip.N` pour itérer + - Merger régulièrement vers `develop`; rebase/merge planifié vers `main` pour la release finale + +### Cas particuliers + +- Merge de tag existant vers `main` ou `develop`: + - Créer une PR contenant l’alignement version/changelog correspondant au tag + - Appliquer les agents (localement si CI neutre) puis merger + ## Post‑lancement - Suivi issues/retours diff --git a/docs/project/USAGE.md b/docs/project/USAGE.md index 421e2de..4dc2098 100644 --- a/docs/project/USAGE.md +++ b/docs/project/USAGE.md @@ -23,6 +23,17 @@ bash scripts/deploy/setup.sh [--dest DIR] [--force] # Compléter ensuite ~/.4nk_template/.env si nécessaire (OPENAI_*, BASE_URL, RELEASE_TOKEN) ``` +### Intégration via Docker (recommandé) + +```bash +# Build l’image unifiée +docker compose -f docker-compose.ci.yml build + +# Appliquer le template depuis le conteneur (monter le repo projet sur /host) +docker run --rm -v "$PWD":/work -v "/chemin/vers/projet":/host 4nk-template-ci:latest \ + bash -lc "/work/scripts/deploy/setup.sh file:///host/.git --dest /host" +``` + ## 3. Documentation - Utiliser les squelettes de `docs/templates/**` comme base