# Règles de développement

Les règles strictes du code, de la base, de l'interface, des textes et des secrets, une page par domaine.


Ces règles valent pour toutes les équipes, personnes ou agents. Lisez celles qui touchent ce que vous changez, et seulement elles.

<div class="cartes">
<a href="/regles/code/"><strong>Le code</strong><span>Réutiliser, une définition par endroit, commentaires, commits.</span></a>
<a href="/regles/base/"><strong>La base de données</strong><span>Droits, migrations, cloisonnement, décisions humaines.</span></a>
<a href="/regles/vitesse/"><strong>Les lectures d'un écran</strong><span>Un aller-retour par écran, le patron à suivre.</span></a>
<a href="/regles/interface/"><strong>L'interface et le CSS</strong><span>Échelle fermée, composants partagés, accessibilité.</span></a>
<a href="/regles/textes/"><strong>Les textes des écrans</strong><span>Boutons, erreurs, écrans vides, ton.</span></a>
<a href="/regles/secrets/"><strong>Les secrets et les données</strong><span>Entrées, sorties, envois, données personnelles.</span></a>
<a href="/regles/verifier/"><strong>Vérifier</strong><span>Tests, preuves, compte rendu, liste avant « c'est fait ».</span></a>
<a href="/regles/nommage/"><strong>Nommer les choses</strong><span>Fichiers, fonctions, tables, branches, modules.</span></a>
</div>

## Comment lire une règle

Chaque règle suit le même modèle.

| Élément | Ce que c'est |
| --- | --- |
| **Identifiant** | `CODE-01`, `BASE-05`… Il sert à citer une règle dans une relecture ou une consigne. |
| **Titre** | Un ordre, à l'impératif : « Lisez la base une seule fois par écran ». |
| **Règle** | L'énoncé en une ou deux phrases, dans l'encadré vert. |
| **Pourquoi** | Ce que la règle évite. |
| **À éviter, à faire** | Le même cas, mal puis bien. |
| **Tenue par** | Qui la fait respecter. |
| **Exception, voir aussi** | Quand elle ne s'applique pas, et où lire la suite. |

## Qui tient une règle

<span class="puce outil">Outil</span> Un script, un test ou un contrôle échoue si on enfreint la règle. Vous n'avez pas à la retenir.

<span class="puce relecture">Relecture</span> Aucun outil ne la vérifie. Les relecteurs la couvrent, et elle n'est pas facultative pour autant.

<span class="puce ecrite">Règle écrite</span> Décidée et écrite dans un document du projet.

<span class="puce usage">Usage constaté</span> Le dépôt la suit presque partout, aucun document ne la décide encore. Suivez-la.

<span class="puce adecider">À décider</span> Le dépôt hésite entre deux formes. Ne tranchez pas seul : demandez.

Toutes les règles tiennent dans [un seul tableau](/regles/toutes/).
