# Critères d’acceptation

## Ce que c'est

Les critères d’acceptation sont les conditions que doit remplir un changement précis pour être
validé. Ils disent ce qu'on pourra observer dans une situation donnée. « Envoyer une confirmation
de rendez-vous » nomme une fonction. « Quand un créneau libre est réservé, la confirmation indique
la référence et l'heure de début inscrites dans la réservation » permet de vérifier une partie du
comportement. La manière de produire la confirmation reste à la décision de l'équipe.

Le manuel de services numériques du gouvernement britannique présente les critères d'un récit
utilisateur comme une liste de résultats à vérifier pour savoir si le service a rempli son rôle.
Le récit présente la personne concernée et son besoin. Les critères rendent l'accord assez concret
pour être discuté, réalisé et vérifié. Un critère peut porter sur un échec, une exigence
d'accessibilité ou une contrainte d'exploitation lorsque ce point compte pour valider le
changement. Les moyens de vérification peuvent varier selon le critère.

Plusieurs documents jouent ici des rôles distincts. Une spécification peut poser des exigences
pour une série de changements. Un cas de test décrit une exécution qui fournit des éléments de
vérification pour un ou plusieurs critères. La Définition de Fini de Scrum indique les mesures de
qualité que doit respecter le travail intégré à un Incrément. Les critères d’acceptation portent
sur un changement particulier. L'accès au clavier peut être une exigence commune, et la
possibilité de réserver puis de consulter un créneau au clavier une condition propre au
changement.

## Pourquoi c'est important

Des critères précis révèlent les désaccords tant qu'il est encore facile de changer de direction.
Pour la personne responsable du service, la réservation peut être acquise dès qu'un enregistrement
existe. La personne qui a pris le rendez-vous peut attendre de recevoir un courriel. L'assistance
peut avoir besoin d'une référence pour aider quelqu'un lorsque le courriel se perd. Il s'agit de
résultats différents. Choisir le moment où l'on affiche la confirmation et définir la conduite à
tenir si l'envoi échoue évite de découvrir le désaccord après la mise en service.

Les critères donnent aussi une cible à la vérification. Une personne peut examiner l'écran de
confirmation et une autre interrompre l'envoi du message. Chacune sait ce qui compterait comme
résultat. L'accessibilité peut demander un parcours au clavier en plus d'un contrôle automatique.
Pour vérifier un délai, il faut un environnement connu et une charge de référence. Écrire « le
système sera rapide » laisse au contraire plusieurs interprétations possibles.

Les normes et le droit s'appliquent même lorsqu'ils ne sont pas copiés dans un récit. Lorsqu'une
interprétation doit être choisie pour le changement, précisons-la. Dans le cas d'un sélecteur de
dates inhabituel, on peut nommer les actions qui doivent rester possibles au clavier et citer la
norme commune. Le critère reste court, sans laisser l'équipe deviner ce qu'il faut vérifier.

## À quoi cela ressemble en pratique

Imaginons un service qui permet de réserver un rendez-vous et de recevoir une confirmation. Une
première version peut indiquer « le rendez-vous peut être réservé et un courriel est envoyé ». Le
responsable du service, la personne qui développe et celle qui vérifie peuvent examiner trois
tentatives précises. Ce sont des exemples fictifs. Les conditions retenues appartiennent à
l'équipe en charge du service.

- Si un créneau de 14 h est disponible dans le fuseau indiqué, une seule réservation est
  confirmée. L'écran indique une référence, une date et une heure qui correspondent à
  l'enregistrement.
- Si le créneau a déjà été pris au moment où le service traite la demande, l'écran indique son
  indisponibilité et permet de revenir aux créneaux libres. Aucune réservation supplémentaire
  n'est créée pour ce créneau.
- Si l'envoi du message échoue après la confirmation de la réservation, le rendez-vous reste
  confirmé. La référence reste visible à l'écran et l'échec est signalé à la personne qui devra y
  donner suite.

Les exemples indiquent un état de départ, une action et un résultat vérifiable. Gherkin exprime
cette structure avec Étant donné, Quand et Alors. Elle peut faciliter la lecture et le lien avec
des tests automatisés. Une liste courte suffit également pour un changement simple. Dans les deux
cas, précisons quelle référence comparer et depuis quel point de vue observer le résultat. La
sortie d'une file d'envoi ne démontre pas qu'un courriel a été reçu.

On exécute la première tentative sur l'écran réel, puis on maîtrise l'ordre des demandes pour la
deuxième. Dans la troisième, on provoque l'échec après la validation de la transaction. Consigner
ces observations permet à une autre personne de refaire la vérification. Notre [déclaration
d’accessibilité](/fr/accessibility/) fournit un exemple de preuve de ce type. Elle décrit les
vérifications au clavier et distingue ce qui a été observé de ce qui demande encore un examen.

## Où les problèmes surviennent

Les termes vagues repoussent la décision jusqu'à la fin. « L'erreur est gérée correctement » ne
précise pas ce que la personne voit et peut encore faire. Nommons l'état, le message, l'action
disponible et l'effet à empêcher. Dans le cas de la réservation, une capture de l'alerte ne suffit
pas. Il faut également regarder si le dossier de réservation a changé.

Un critère peut aussi imposer trop tôt une technique. « Utiliser la nouvelle file » peut
correspondre à une décision valable, sans expliquer ce qui se passe lorsqu'une confirmation tarde.
Documentons la décision d'architecture et formulons séparément le comportement à observer. Si une
intégration externe impose un protocole, citons sa source et indiquons la limite où il s'applique.

À l'inverse, une liste peut devenir si vaste qu'elle décrit toute une version. Séparons le travail
par résultat, en gardant le cas d'échec important à côté du parcours correspondant. Convenons des
contraintes communes et de la personne responsable de la vérification du changement. Si un essai
découvre une condition oubliée, indiquons la raison de sa modification et répétons les
vérifications concernées. Le dossier gardera l'accord qui a effectivement été vérifié.

## Pour aller plus loin

- [Manuel du gouvernement britannique sur les récits utilisateurs et leurs
  critères](https://www.gov.uk/service-manual/agile-delivery/writing-user-stories)
- [Référence Gherkin pour rédiger des scénarios](https://cucumber.io/docs/gherkin/reference/)
- [Définition de Fini dans le Guide
  Scrum](https://scrumguides.org/scrum-guide.html#definition-of-done)
- [Guide du W3C pour vérifier l'utilisation au
  clavier](https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html)

<https://engineer.company/fr/glossary/acceptance-criteria/>
