From 69db2f66d5048a2409f0373958112666ef578aab Mon Sep 17 00:00:00 2001 From: Alpinux Date: Sat, 19 Sep 2026 23:03:14 +0200 Subject: [PATCH] =?UTF-8?q?Dire=20d'o=C3=B9=20part=20un=20nouvel=20article?= =?UTF-8?q?=20:=20de=20sa=20bifurcation,=20=C3=A0=20jour?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Le schéma de la vue d'ensemble sautait la bifurcation et laissait croire qu'on édite le dépôt du wiki lui-même. Il décrit maintenant le vrai parcours, et le cas des mainteneurs tient dans un encadré : branche et pull request quand même, la bifurcation devient facultative. L'étape « Proposer un nouvel article » commençait au bouton « Nouveau fichier », sans dire où. Elle part désormais de la bifurcation, et insiste sur ce qui mord : une copie ne se met pas à jour toute seule, et un article écrit sur une version dépassée finit en conflit. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01BE4rvHVETRoWnYNDTGssdo --- docs/contribuer/index.md | 46 +++++++++++++++++++++++++++++++++------- 1 file changed, 38 insertions(+), 8 deletions(-) diff --git a/docs/contribuer/index.md b/docs/contribuer/index.md index 04006da..ee6435f 100644 --- a/docs/contribuer/index.md +++ b/docs/contribuer/index.md @@ -14,15 +14,21 @@ Ce wiki appartient à toute la communauté Alpinux. Si vous repérez une faute, ## Vue d'ensemble du processus ``` -Vous → AlpID → Gitea → Mainteneurs → Wiki en ligne -Créez un compte Vous connecte Vous éditez Relisent et MkDocs publie -sur AlpID à Gitea la page acceptent automatiquement - + ouvrez une votre - pull request contribution +Compte AlpID → Bifurcation → Branche → Pull request → Mainteneurs → Wiki +Vous connecte Votre copie Vos Vous la Relisent et MkDocs +à la forge personnelle modifs proposez fusionnent publie + du wiki y sont au wiki la fusion + isolées ``` -En résumé : vous proposez une modification, un mainteneur la valide, et le wiki se met à -jour tout seul — en quelques secondes, sans intervention de personne. +Le point important : **vous n'écrivez jamais dans le dépôt du wiki**. Vous écrivez dans +votre bifurcation — votre copie personnelle, où vous ne risquez rien — puis vous +proposez ce travail par une pull request. Un mainteneur relit, fusionne, et le site se +met à jour tout seul dans les secondes qui suivent. + +!!! note "Et si j'ai les droits d'écriture sur le dépôt ?" + La règle reste la même : une branche, puis une pull request, même pour les + mainteneurs. La bifurcation devient alors facultative, rien d'autre ne change. !!! note "Deux façons de contribuer" Ce guide décrit la voie **depuis le navigateur**, celle qui ne demande aucune @@ -110,6 +116,29 @@ C'est la façon la plus simple de contribuer : corriger une faute, compléter un Vous avez rédigé un guide ou un compte-rendu et souhaitez l'ajouter au wiki. +### Partir de sa bifurcation + +Un nouvel article ne se crée pas dans le dépôt du wiki, mais dans **votre bifurcation**. +Si vous n'en avez pas encore, créez-la : sur +[le dépôt du wiki](https://gitea.alpinux.org/alpinux.cedrica5l/alpinux-wiki), bouton +**« Bifurcation »** (*Fork*) en haut à droite. Vous obtenez une copie complète du wiki +dans votre espace personnel sur la forge, sur laquelle vous avez tous les droits. + +!!! warning "Une bifurcation vieillit" + Votre copie ne se met pas à jour toute seule : elle reste figée au jour où vous + l'avez créée. **Avant d'écrire, récupérez l'état actuel du wiki**, sinon votre + article partira d'une version dépassée et la pull request risque le conflit. + + - **Depuis la forge** : sur votre bifurcation, le bandeau + *« Cette branche est en retard de N commits »* propose un bouton de + synchronisation — cliquez-le. + - **Depuis votre ordinateur** : `git pull upstream main`, après avoir déclaré le + dépôt du wiki comme `upstream`. La marche à suivre complète est dans + [Rédiger en ligne de commande](ligne-de-commande.md#1-bifurquer-puis-cloner). + + Pour un article un peu long, travailler depuis son ordinateur est nettement plus + confortable que l'éditeur du navigateur — et c'est la même pull request au bout. + ### Choisir le bon dossier Avant de créer votre fichier, identifiez dans quelle section il a sa place : @@ -123,7 +152,8 @@ Avant de créer votre fichier, identifiez dans quelle section il a sa place : ### Créer le fichier -1. Naviguez dans le dépôt vers le bon dossier (ex. `docs/guides/`). +1. Dans **votre bifurcation** (et non dans le dépôt du wiki), naviguez vers le bon + dossier (ex. `docs/guides/`). 2. Cliquez sur le bouton **« + »** ou **« Nouveau fichier »** en haut à droite de la liste des fichiers.