Ustagammon/docs/tutoriel

Tutoriel des règles

Le texte du tutoriel de l'application, en une seule source (ADR 0008) : regles.md. make site copie ce dossier dans le site publié (docs/tutoriel/) ; l'application le lit à l'exécution (app/src/ui/tutorial-text.ts), et make test vérifie chaque position et chaque coup avec le vrai moteur (app/tests/tutorial.test.ts).

Texte sous licence CC BY-SA 4.0. Première version, rédigée par Claude Code d'après la charte (docs/identite/charte/accueil-tutoriel-aide.md), à valider par Pierre.

Format

Tout ce qui précède la première étape (ce titre, cette notice) n'est pas affiché.

## 3. Les dés et les doubles

- position: 4HPwATDgc/ABMA
- jet: 5-2
- coup: 13/11 13/8

Un paragraphe, avec un [mot du glossaire](pion.md) et du **gras**.

### À vous

- position: 4HPwATDgc/ABMA
- jet: 3-1
- attendu: 8/5 6/5
- juste: La phrase affichée quand le coup est juste.
- refus: La phrase affichée quand le coup est refusé.

La consigne de l'écran.

## Fin

- action: Jouer ma première partie

Le texte de la fin du tutoriel.

• ## <n>. <titre> commence l'étape n (huit au plus, dans l'ordre) ; ### À vous commence son écran « à vous », facultatif ; ## Fin, l'écran qui suit la dernière étape.
• Les lignes - clé: valeur en tête d'écran le décrivent :
  • position : l'identifiant de position de GNU Backgammon (ADR 0013), vu du camp au trait ;
  • trait : ordinateur si c'est l'ordinateur qui a la main dans cette position (par défaut, vous) ;
  • jet et coup : sur un écran d'explication, le coup illustré, qui se joue tout seul (notation de gnubg) ;
  • chemin: oui : le sens du jeu, deux flèches circulaires sur le plateau (claire pour vos pions, sombre pour ceux de l'ordinateur) ;
  • attendu (une ligne par coup accepté) : sur un écran « à vous », les coups justes, en notation de gnubg, tels que le moteur les écrit ;
  • réponse : prendre ou passer, pour un écran « à vous » où l'ordinateur double ; le moteur doit donner la même réponse ;
  • juste et refus : les phrases qui suivent un geste juste, ou refusé ;
  • action : le libellé du bouton de la fin.
• Les autres lignes forment les paragraphes. [mot](fiche.md) renvoie à une fiche du glossaire, à la première apparition du mot.

Aucune règle n'est écrite dans le code : le moteur lit les positions, illustre les coups, juge les coups joués et les décisions de videau.