Contribuer par le dépôt

Le mode d’emploi de la voie 2, publié ici pour qu’on puisse le lire avant de demander l’accès qu’il décrit. Il est régénéré depuis CONTRIBUTING.md à chaque construction du site : les deux ne peuvent pas diverger.

← Retour à la page « Contribuer »

Ce document s'adresse à un chercheur, un juriste ou un praticien qui utilise git de temps en temps — pas tous les jours. Il ne suppose rien d'autre qu'un terminal et un peu de patience. Si git vous bloque, ne perdez pas une heure dessus : envoyez votre contribution par courriel à nizar.yaiche@ystrat.com en suivant le gabarit de la page « Contribuer » du site. Elle sera traitée exactement de la même manière.

Ce qui est attendu dans une contribution, et ce qui sera refusé, est décrit sur le site, page Contribuer. Le présent fichier ne traite que de la mécanique du dépôt.

1. Le principe, en une minute

Il n'y a ni fil de commentaires, ni compte à créer, ni base de données. Les contributions passent par le dépôt git de l'ouvrage, qui tient déjà ce qu'un site participatif aurait dû reconstruire : l'historique, l'attribution nominative, la relecture avant publication et la possibilité de revenir en arrière.

Rien n'est publié avant d'avoir été lu. La relecture est faite avant mise en ligne, jamais après. Le coordinateur est seul et consacre deux à trois heures par semaine à cette relecture : tout ce qui suit — le gabarit, l'exigence de source, la taille des branches — découle de cette seule contrainte.

2. Obtenir l'accès et cloner

L'accès en écriture est nominatif. Il n'existe pas de lien d'édition partageable : c'est ce qui garantit que chaque ligne du dépôt a un auteur identifié.

1. Écrivez à nizar.yaiche@ystrat.com en indiquant votre nom, votre affiliation, votre ORCID si vous en avez un, et en une phrase ce sur quoi vous voulez travailler.
2. Vous recevez en retour l'URL du dépôt et l'autorisation associée à votre clé SSH publique. L'invitation est valable 14 jours ; passé ce délai, elle est renvoyée sur simple demande.
3. Clonez :

git clone <URL-du-dépôt-communiquée-dans-l'invitation> humanity-compact
cd humanity-compact
git config user.name  "Prénom Nom"
git config user.email "adresse@exemple.org"

Le nom et l'adresse configurés ici sont ceux qui apparaîtront publiquement dans l'historique et sur la page des contributeurs. Mettez-y la forme sous laquelle vous souhaitez être cité.

> Le dépôt est lourd (l'ouvrage et ses éditions PDF y sont versionnés). Un premier > clonage peut prendre plusieurs minutes. Si vous ne travaillez que sur du texte, > git clone --filter=blob:limit=10m suffit largement.

3. Une branche, un sujet

Ne travaillez jamais sur master. Partez toujours de master à jour, et créez une branche dont le nom dit qui vous êtes et sur quoi vous travaillez :

git checkout master
git pull
git checkout -b contrib/<vos-initiales>-<sujet-en-trois-mots>

Par exemple : contrib/ml-taux-fmi-esr2023, contrib/jd-objection-mandats-negatifs.

Une branche = un sujet = une décision. Une branche qui corrige un chiffre du §7.2 et propose au passage une refonte de l'annexe F ne peut être ni acceptée ni refusée : elle sera renvoyée à découper, ce qui vous coûtera plus de temps que de l'avoir découpée d'emblée.

Ordre de grandeur visé : moins de 400 lignes modifiées par branche. Au-delà, écrivez d'abord pour dire ce que vous comptez faire.

4. Le message de commit

Le message n'est pas une formalité : c'est ce que le coordinateur lit avant le diff, et c'est ce qui décide du temps de traitement. Format :

<type>(<section>): <résumé à l'impératif, 72 signes au plus>

<Corps : ce qui change et pourquoi. Une idée par paragraphe.
Si un chiffre change, dire l'ancienne valeur et la nouvelle.>

Source: <référence complète, URL ou DOI> — consultée le AAAA-MM-JJ
Accord-de-contribution: v1 (Prénom Nom <adresse@exemple.org>)

Trois types, et trois seulement :

| Type | Ce qu'il désigne | |---|---| | errata | Coquille, lien mort, renvoi erroné, légende qui contredit sa figure. Aucune source n'est exigée quand le fait est vérifiable dans le document lui-même. | | source | Une correction de fond appuyée sur une source externe : chiffre, date, attribution, référence. Une ligne Source: au moins est obligatoire. | | fond | Un texte nouveau publié sous votre signature. Suppose une fiche acceptée au préalable (voir la page « Contribuer »). |

Exemple complet :

source(§7.2): corriger le solde courant agrégé 2023 des pays du G20

Le tableau 18 donnait un solde agrégé de 1,4 % du PIB mondial. L'édition 2023
du External Sector Report retient 0,9 %, la différence tenant au traitement
des revenus primaires des entités à vocation spéciale.

Ancienne valeur : 1,4 %  —  nouvelle valeur : 0,9 %

Source: IMF (2023), External Sector Report: External Rebalancing in Turbulent
Times, Washington DC, tableau 1.2, p. 12 — consultée le 2026-08-11
Accord-de-contribution: v1 (Marie Legrand <marie.legrand@exemple.org>)

La ligne Accord-de-contribution vous est demandée une fois. Elle vaut acceptation de l'accord de licence de contribution (page « Contribuer » → « Licence ») : vous conservez votre droit d'auteur, vous concédez une licence CC BY 4.0. Une contribution qui ne la porte pas n'est pas refusée — elle attend.

5. Envoyer

git add <les fichiers concernés>   # jamais `git add .` : voir plus bas
git commit                          # git ouvre votre éditeur, écrivez le message
git push -u origin contrib/<votre-branche>

Puis un courriel d'une ligne à nizar.yaiche@ystrat.com annonçant la branche. C'est tout : il n'y a pas de formulaire.

N'utilisez pas git add .. Le dépôt contient des documents de travail volumineux ; un add . distrait ajoute des fichiers temporaires, des .docx verrouillés par Word, ou une sauvegarde de 40 Mo. Vérifiez toujours par git status puis git diff --cached avant de valider.

6. Ce qui déclenche un refus

> La règle de sourçage fait foi sur la page Contribuer (section « une source publiquement vérifiable ») ; cette section ne reprend que la mécanique du dépôt.

Un refus est motivé, et le motif est toujours pris dans cette liste. Il porte sur un texte, jamais sur son auteur : une contribution refusée peut être reprise et représentée.

Sur le fond

• Aucune source, ou source invérifiable. C'est le premier motif de refus, et il ne souffre aucune exception pour un commit de type source ou fond. Un document interne, une conversation, « de source sûre », une capture d'écran sans lien : rien de tout cela n'est vérifiable par un tiers.
• La source ne dit pas ce qu'on lui fait dire. Chaque citation est vérifiée à la page indiquée.
• Hors périmètre. Le texte ne se rattache à aucune section de l'ouvrage.
• Mise en cause d'une personne nommée. L'ouvrage discute des fonctions, des mandats et des architectures — jamais des personnes. C'est une règle absolue.
• Plaidoyer, communiqué, promotion d'une organisation, d'un produit ou d'une cause.
• Texte déjà publié ailleurs sans que vous en déteniez les droits.
• Volume disproportionné d'un même contributeur sur une courte période : le débit de relecture est la ressource rare.

Sur la forme

• Branche qui mélange plusieurs sujets, ou qui part d'ailleurs que de master.
• Message de commit sans corps, ou sans ligne Source: pour un commit source / fond.
• Fichiers binaires ajoutés sans nécessité ; fichiers générés (site/dist/) validés à la main — ils sont produits par la chaîne de génération, jamais édités.
• Réécriture de style qui change le sens sans l'annoncer.
• Historique réécrit après relecture entamée (push --force sur une branche déjà lue).

7. Délais annoncés

| Étape | Délai | Ce que vous recevez | |---|---|---| | Accusé de réception | 5 jours ouvrés | Confirmation que la contribution est lisible et complète, ou la liste des champs manquants. | | Décision | 15 jours ouvrés | Acceptée, acceptée sous réserve de modification, ou refusée avec le motif ci-dessus. | | Publication | à la régénération suivante du site | La contribution paraît sous votre signature, et votre entrée apparaît à la page des contributeurs. |

La relecture a lieu par sessions hebdomadaires. Une contribution déposée le mardi n'est pas lue le mercredi : elle est lue à la session suivante. Sans nouvelle au bout de 20 jours ouvrés, relancez — un courriel se perd, et une relance n'a jamais été mal prise.

8. Après acceptation

Le coordinateur fusionne votre branche dans master et régénère le site. Votre nom, votre affiliation et votre ORCID sont ajoutés à site/data/participation.json, qui alimente la page des contributeurs. Vous n'avez rien à faire.

Vous pouvez demander à tout moment que votre nom cesse de figurer sur cette page. Une licence concédée sur un texte déjà publié reste en revanche irrévocable : c'est ce qui permet à un lecteur de citer ce site sans craindre que la page disparaisse sous sa référence.

9. Comment citer

Le fichier CITATION.cff, à la racine, donne la référence lisible par machine. GitHub, Zotero et la plupart des gestionnaires bibliographiques savent le lire. Pour l'ouvrage lui-même, citez l'édition PDF et sa version ; pour ce site, précisez en outre la version des données affichée en pied de page.

Convention éditoriale : introduire chaque figure et chaque tableau

Règle pour toute révision ou nouvelle unité (refonte du 22/09/2026, proposition 20.10) : un tableau ou une figure substantiels sont précédés d'une phrase courte, en position de question ou d'annonce, qui dit ce que le lecteur doit y chercher. Le contenu existant n'est pas réécrit rétroactivement ; la convention s'applique à mesure des révisions.