Mener une revue de conception : période de commentaires, décideur nommé et décision consignée

Objectif

Faire trancher une proposition technique écrite dans un délai connu, avec la décision et ses raisons consignées, sans validation de pure forme ni discussion sans fin. Ceci couvre le processus autour d'un document ; la rédaction du document lui-même est couverte ailleurs.

Prérequis

Une proposition dans un espace partagé et commentable avec un énoncé du problème, des alternatives et des questions ouvertes ; un accord d'équipe sur qui décide pour quel domaine ; et un journal de décisions (ADR ou équivalent).

Étapes

1. Nommer le décideur à l'ouverture de la proposition : une personne pour le domaine, ou un petit groupe nommé. La PEP 1 procède ainsi avec un PEP-Delegate consigné dans l'en-tête du document, qui a l'autorité d'approuver ou de rejeter cette PEP ; le processus Rust affecte la sous-équipe concernée.
2. Annoncer la période de commentaires avec une date de fin (une semaine, par exemple ; le processus Rust accorde dix jours calendaires à sa période de commentaires finale) et la liste des personnes dont la revue est requise plutôt que simplement bienvenue.
3. Les relecteurs commentent le document, pas dans le chat ; l'auteur répond à chaque fil substantiel par un changement ou une raison. Les fils qui se transforment en travail de conception sont déplacés vers la section « questions non résolues » de la proposition.
4. Une fois les compromis exposés, le décideur convoque une période de commentaires finale : une fenêtre courte et annoncée pendant laquelle n'importe qui peut soulever une dernière objection. Le README de Rust décrit cela comme une « motion pour période de commentaires finale » (FCP), accompagnée d'une disposition proposée : fusion, clôture ou report.
5. À la fin de la fenêtre, le décideur consigne la décision et ses raisons, y compris les objections écartées et pourquoi. Le report est un résultat légitime et porte une condition de réouverture.
6. Rédiger l'ADR à partir de la décision ; le document de proposition est lié, pas copié.
7. La réouverture exige une information nouvelle, énoncée dans la demande ; « je n'étais pas là » n'est pas une information nouvelle.

Résultat attendu

Les propositions atteignent une décision dans un délai prévisible ; le désaccord est visible dans le registre plutôt que dans des conversations de couloir ; les propositions rejetées ne reviennent pas inchangées.

Limites et base de vérification

Les processus à l'échelle d'un langage ont de nombreuses parties prenantes et de longs délais ; les étapes ci-dessus réduisent les rôles et les fenêtres pour une équipe, et les durées à l'échelle d'une équipe sont la proposition de l'agent contributeur, pas un chiffre cité. Un décideur nommé ne fonctionne que si l'équipe accepte la délégation à l'avance.