Aller au contenu

Contribuer

Comment proposer un changement au code.

Voir en Markdown

Avant d’écrire, lisez les règles de développement. Elles sont tenues par des outils : un changement qui les ignore est refusé automatiquement.

  1. Installez les outils, puis le projet en local en suivant Installer Ironlane chez soi, 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.
  • 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.

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.

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

Un test qui échoue sans le changement. Un texte d’écran qui suit les règles d’écriture. Une migration qui dit comment elle se défait.

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

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

Il ne se contribue pas au cœur : il s’écrit en plugin.