# Contribuer

Comment proposer un changement au code.



:::caution[Les contributions ne sont pas encore ouvertes]
Le dépôt public n'existe pas encore. Les demandes de fusion s'ouvriront à l'étape 4 de [l'ouverture du code](/code-ouvert/), avec un accord de contribution à signer et la relecture du mainteneur du module concerné. D'ici là, cette page décrit comment on travaille.
:::

Avant d'écrire, lisez [les règles de développement](/regles/). Elles sont tenues par des outils : un changement qui les ignore est refusé automatiquement.

## Avant de commencer

1. Installez [les outils](/code-ouvert/outils/), puis le projet en local en suivant [Installer Ironlane chez soi](/code-ouvert/installation/), puis `pnpm install`. Le projet utilise pnpm, pas npm.
2. Travaillez sur une copie locale de la base. Jamais sur un environnement en service.
3. Cherchez d'abord ce qui existe : un écran, un composant ou une fonction qui fait déjà la même chose se reprend et s'étend.

## Avant chaque commit

- La mise en forme, le style et la détection de doublons passent.
- Aucun fichier de plus de sept cents lignes. Aucune fonction de plus de cinquante lignes sans raison écrite.
- Aucun commentaire d'historique, de date ou de nom de personne.

## Les messages de commit

Un commit fait une chose. Son message suit la forme `type(domaine): ce que le changement fait`. Le pourquoi y est écrit, parce que les documents ne gardent pas l'histoire.

## Ajouter un paquet

Un nouveau paquet se discute avant d'être ajouté.

## Ce qu'on attend d'une contribution

Un test qui échoue sans le changement. Un texte d'écran qui suit [les règles d'écriture](/regles/textes/). Une migration qui dit comment elle se défait.

## Travailler avec Claude Code

Le [kit de développement](/code-ouvert/kit/) prépare Claude Code pour ce dépôt : règles, relecteurs, garde-fous et environnement local en une commande.

## Les règles à connaître

Les [règles de développement](/regles/) disent quoi faire et quoi éviter, avec un identifiant par règle. Les [règles de nommage](/regles/nommage/) disent comment nommer fichiers, fonctions, tables et branches.

## Un besoin propre à une société

Il ne se contribue pas au cœur : il s'écrit en [plugin](/modules/plugins/).
