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:
parent
c52652f07e
commit
69db2f66d5
1 changed files with 38 additions and 8 deletions
|
|
@ -14,15 +14,21 @@ Ce wiki appartient à toute la communauté Alpinux. Si vous repérez une faute,
|
||||||
## Vue d'ensemble du processus
|
## Vue d'ensemble du processus
|
||||||
|
|
||||||
```
|
```
|
||||||
Vous → AlpID → Gitea → Mainteneurs → Wiki en ligne
|
Compte AlpID → Bifurcation → Branche → Pull request → Mainteneurs → Wiki
|
||||||
Créez un compte Vous connecte Vous éditez Relisent et MkDocs publie
|
Vous connecte Votre copie Vos Vous la Relisent et MkDocs
|
||||||
sur AlpID à Gitea la page acceptent automatiquement
|
à la forge personnelle modifs proposez fusionnent publie
|
||||||
+ ouvrez une votre
|
du wiki y sont au wiki la fusion
|
||||||
pull request contribution
|
isolées
|
||||||
```
|
```
|
||||||
|
|
||||||
En résumé : vous proposez une modification, un mainteneur la valide, et le wiki se met à
|
Le point important : **vous n'écrivez jamais dans le dépôt du wiki**. Vous écrivez dans
|
||||||
jour tout seul — en quelques secondes, sans intervention de personne.
|
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"
|
!!! note "Deux façons de contribuer"
|
||||||
Ce guide décrit la voie **depuis le navigateur**, celle qui ne demande aucune
|
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.
|
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
|
### Choisir le bon dossier
|
||||||
|
|
||||||
Avant de créer votre fichier, identifiez dans quelle section il a sa place :
|
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
|
### 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.
|
2. Cliquez sur le bouton **« + »** ou **« Nouveau fichier »** en haut à droite de la liste des fichiers.
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue