ADR 0008 : glossaire et scénarios, source unique pour le code, l'aide et les tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 13:45:34 +01:00
parent 463bc6f553
commit 77ca5a60ca
36 changed files with 518 additions and 1 deletions
@@ -0,0 +1,60 @@
+# Glossaire
+
+Les mots du jeu, une fiche par terme, avec leur traduction anglaise utilisée
+dans le code (ADR 0008). Ces fiches sont la seule source : l'application les
+affiche telles quelles quand on touche un terme.
+
+Fiches rédigées par Claude Code, **à relire** par Pierre (contenu pédagogique,
+CC BY-SA 4.0).
+
+## Format d'une fiche
+
+```
+---
+term: Videau
+english: Cube
+code: Cube
+---
+# Videau
+
+**En bref** : une phrase, celle qu'affiche l'application.
+
+Détails facultatifs.
+
+Voir aussi : [Doubler](doubler.md)
+```
+
+`code` est facultatif : il désigne le type du domaine qui implémente le terme,
+dès qu'il existe. Dans le code, ce type porte en commentaire le chemin de sa
+fiche (`Glossaire : docs/glossaire/videau.md`).
+
+## Termes
+
+| Terme | Anglais (code) |
+| --- | --- |
+| [Backgammon](backgammon.md) | Backgammon |
+| [Barre](barre.md) | Bar |
+| [Blot](blot.md) | Blot |
+| [Branche](branche.md) | Branch |
+| [Compte de points](compte-de-points.md) | Pip count |
+| [Coup](coup.md) | Move |
+| [Course](course.md) | Race |
+| [Doubler](doubler.md) | Double |
+| [Équité](equite.md) | Equity |
+| [Événement de partie](evenement-de-partie.md) | Game event |
+| [Gammon](gammon.md) | Gammon |
+| [Identifiant de match](identifiant-de-match.md) | Match ID |
+| [Identifiant de position](identifiant-de-position.md) | Position ID |
+| [Jet](jet.md) | Roll |
+| [Match](match.md) | Match |
+| [Moteur](moteur.md) | Engine |
+| [Partie](partie.md) | Game |
+| [Passer](passer.md) | Drop |
+| [Pion](pion.md) | Checker |
+| [Pli](pli.md) | Ply |
+| [Point](point.md) | Point |
+| [Prendre](prendre.md) | Take |
+| [Règle de Crawford](regle-de-crawford.md) | Crawford rule |
+| [Règle de Jacoby](regle-de-jacoby.md) | Jacoby rule |
+| [Sortie](sortie.md) | Bear-off |
+| [Videau](videau.md) | Cube |
@@ -0,0 +1,9 @@
+---
+term: Backgammon
+english: Backgammon
+---
+# Backgammon
+
+**En bref** : victoire triple : l'adversaire n'a sorti aucun pion et en a encore sur la barre ou dans votre dernier quart du plateau.
+
+Voir aussi : [Gammon](gammon.md)
@@ -0,0 +1,9 @@
+---
+term: Barre
+english: Bar
+---
+# Barre
+
+**En bref** : bande centrale du plateau où vont les pions frappés ; un joueur doit y faire rentrer ses pions avant de jouer les autres.
+
+Voir aussi : [Blot](blot.md)
@@ -0,0 +1,9 @@
+---
+term: Blot
+english: Blot
+---
+# Blot
+
+**En bref** : pion seul sur un point : l'adversaire peut le frapper et l'envoyer sur la barre.
+
+Voir aussi : [Point](point.md), [Barre](barre.md)
@@ -0,0 +1,9 @@
+---
+term: Branche
+english: Branch
+---
+# Branche
+
+**En bref** : suite de coups rejouée à partir d'un moment d'une partie (« Rejouer d'ici ») ; la partie d'origine reste intacte.
+
+Voir aussi : [Événement de partie](evenement-de-partie.md)
@@ -0,0 +1,9 @@
+---
+term: Compte de points
+english: Pip count
+---
+# Compte de points
+
+**En bref** : nombre total de cases que vos pions doivent encore parcourir pour tous sortir ; le plus petit compte est en avance dans la course.
+
+Voir aussi : [Course](course.md)
@@ -0,0 +1,9 @@
+---
+term: Coup
+english: Move
+---
+# Coup
+
+**En bref** : le déplacement complet des pions pour un jet, noté par exemple 8/5 6/5 : un pion de la case 8 à la case 5, un autre de la case 6 à la case 5.
+
+Voir aussi : [Jet](jet.md)
@@ -0,0 +1,9 @@
+---
+term: Course
+english: Race
+---
+# Course
+
+**En bref** : position où les pions des deux joueurs se sont croisés : plus aucun contact n'est possible, c'est au plus rapide.
+
+Voir aussi : [Compte de points](compte-de-points.md), [Sortie](sortie.md)
@@ -0,0 +1,9 @@
+---
+term: Doubler
+english: Double
+---
+# Doubler
+
+**En bref** : proposer à l'adversaire, avant de lancer les dés, de doubler la valeur de la partie ; il peut prendre ou passer.
+
+Voir aussi : [Videau](videau.md)
@@ -0,0 +1,9 @@
+---
+term: Équité
+english: Equity
+---
+# Équité
+
+**En bref** : ce que vaut une position selon le moteur, en points gagnés ou perdus en moyenne : +1 pour une victoire simple assurée, −1 pour une défaite simple assurée.
+
+Voir aussi : [Moteur](moteur.md), [Pli](pli.md)
@@ -0,0 +1,9 @@
+---
+term: Événement de partie
+english: Game event
+---
+# Événement de partie
+
+**En bref** : ce qui s'est passé à un moment de la partie : un jet, un coup, un double… ; une partie est la suite de ses événements.
+
+Voir aussi : [Branche](branche.md), [Partie](partie.md)
@@ -0,0 +1,9 @@
+---
+term: Gammon
+english: Gammon
+---
+# Gammon
+
+**En bref** : victoire double : l'adversaire n'a sorti aucun pion quand vous avez sorti tous les vôtres.
+
+Voir aussi : [Backgammon](backgammon.md)
@@ -0,0 +1,9 @@
+---
+term: Identifiant de match
+english: Match ID
+---
+# Identifiant de match
+
+**En bref** : code de 12 caractères qui décrit le reste de l'état du jeu : score, videau, joueur au trait, dés ; c'est le format de GNU Backgammon.
+
+Voir aussi : [Identifiant de position](identifiant-de-position.md)
@@ -0,0 +1,9 @@
+---
+term: Identifiant de position
+english: Position ID
+---
+# Identifiant de position
+
+**En bref** : code de 14 caractères, par exemple 4HPwATDgc/ABMA, qui décrit la place de tous les pions ; c'est le format de GNU Backgammon.
+
+Voir aussi : [Identifiant de match](identifiant-de-match.md)
@@ -0,0 +1,9 @@
+---
+term: Jet
+english: Roll
+---
+# Jet
+
+**En bref** : le lancer des deux dés ; un double (deux dés identiques) se joue quatre fois.
+
+Voir aussi : [Coup](coup.md)
@@ -0,0 +1,9 @@
+---
+term: Match
+english: Match
+---
+# Match
+
+**En bref** : suite de parties jouée jusqu'à ce qu'un joueur atteigne un nombre de points fixé à l'avance, par exemple 5 points.
+
+Voir aussi : [Partie](partie.md), [Règle de Crawford](regle-de-crawford.md)
@@ -0,0 +1,9 @@
+---
+term: Moteur
+english: Engine
+---
+# Moteur
+
+**En bref** : GNU Backgammon, le programme qui calcule les coups, le videau et les évaluations ; Ustagammon ne décide jamais rien sans lui.
+
+Voir aussi : [Équité](equite.md), [Pli](pli.md)
@@ -0,0 +1,9 @@
+---
+term: Partie
+english: Game
+---
+# Partie
+
+**En bref** : une partie se joue jusqu'à ce qu'un joueur ait sorti tous ses pions ; elle rapporte 1, 2 ou 3 points, multipliés par la valeur du videau.
+
+Voir aussi : [Match](match.md), [Gammon](gammon.md), [Videau](videau.md)
@@ -0,0 +1,9 @@
+---
+term: Passer
+english: Drop
+---
+# Passer
+
+**En bref** : refuser un double : vous abandonnez la partie et perdez sa valeur d'avant le double.
+
+Voir aussi : [Prendre](prendre.md), [Videau](videau.md)
@@ -0,0 +1,7 @@
+---
+term: Pion
+english: Checker
+---
+# Pion
+
+**En bref** : chacun des 15 jetons d'un joueur.
@@ -0,0 +1,9 @@
+---
+term: Pli
+english: Ply
+---
+# Pli
+
+**En bref** : profondeur de calcul du moteur : à 0 pli il juge la position telle quelle, à 2 plis il examine aussi les jets suivants des deux joueurs ; plus de plis, c'est plus fort et plus lent.
+
+Voir aussi : [Moteur](moteur.md)
@@ -0,0 +1,9 @@
+---
+term: Point
+english: Point
+---
+# Point
+
+**En bref** : chacune des 24 flèches du plateau ; un point est « fait » quand au moins deux de vos pions l'occupent, et l'adversaire ne peut plus s'y poser.
+
+Voir aussi : [Blot](blot.md)
@@ -0,0 +1,9 @@
+---
+term: Prendre
+english: Take
+---
+# Prendre
+
+**En bref** : accepter un double : la partie continue à valeur doublée, et vous possédez le videau, vous seul pourrez redoubler.
+
+Voir aussi : [Passer](passer.md), [Videau](videau.md)
@@ -0,0 +1,9 @@
+---
+term: Règle de Crawford
+english: Crawford rule
+---
+# Règle de Crawford
+
+**En bref** : en match, dans la partie qui suit le moment où un joueur arrive à un point de la victoire, personne ne peut doubler.
+
+Voir aussi : [Match](match.md), [Doubler](doubler.md)
@@ -0,0 +1,9 @@
+---
+term: Règle de Jacoby
+english: Jacoby rule
+---
+# Règle de Jacoby
+
+**En bref** : en partie libre, hors match, un gammon ou un backgammon ne compte que si le videau a été utilisé.
+
+Voir aussi : [Gammon](gammon.md), [Videau](videau.md)
@@ -0,0 +1,9 @@
+---
+term: Sortie
+english: Bear-off
+---
+# Sortie
+
+**En bref** : dernière phase : quand tous ses pions sont dans son dernier quart du plateau, un joueur peut les retirer du jeu ; le premier à tout sortir gagne.
+
+Voir aussi : [Course](course.md)
@@ -0,0 +1,9 @@
+---
+term: Videau
+english: Cube
+---
+# Videau
+
+**En bref** : le dé à doubler, marqué 2, 4, 8, 16, 32 et 64 : il indique la valeur actuelle de la partie.
+
+Voir aussi : [Doubler](doubler.md), [Prendre](prendre.md), [Passer](passer.md)