Dire d'où part un nouvel article : de sa bifurcation, à jour

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) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BE4rvHVETRoWnYNDTGssdo
This commit is contained in:
Alpinux 2026-09-19 23:03:14 +02:00
parent c52652f07e
commit 69db2f66d5

View file

@ -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.