Règles de rédaction des en-têtes de code
Chaque fichier de code porte un en-tête court qui explique son rôle. Il aide les humains comme les agents IA à se repérer sans lire tout le fichier.
- Une à trois lignes, en tête de fichier, avant le code.
- Décrire le rôle du fichier, pas son implémentation ligne à ligne.
- Signaler toute contrainte : fichier généré, à ne pas éditer, dépendances.
- Style concis ; pas de redite du nom de fichier.
# Module de service : reverse-proxy Caddy pour les services de zone.# Options sous `darkone.service.caddy`. Voir dnf/AGENTS.md pour les conventions.{ config, lib, ... }: