Charte : retours des premiers joueurs #54

2026-11-11T21:00:44Z

pierre commented

2026-11-11 21:00:44 +00:00

Pourquoi

Les premiers joueurs ont donné leurs retours à Pierre le 2026-11-11 (« C'est vraiment pas mal, ça avance bien »), avec quatre demandes :

les numéros des flèches à l'extérieur du plateau ;
parler des jans pour simplifier les explications ;
des pions blancs et noirs plutôt qu'ivoire et ébène ;
deux flèches circulaires, blanche et noire, pour montrer le sens du jeu dans le tutoriel.

Pierre ajoute que le vrai problème est qu'« on voit mal les pions sombres sur la barre ». C'est confirmé par le calcul : le contour noir des pions sombres a un contraste proche de 1:1 avec la barre en noyer, et en thème sombre les pions sombres se détachent mal du plateau.

Quoi

Pions sombres lisibles : le contour et le filet des pions de l'ordinateur (checker-computer-edge) deviennent clairs (#B8AC98) dans les deux thèmes. Ils se détachent sur la barre, sur les flèches sombres et en thème sombre.
Recette (recette-ux.md), deux règles nouvelles : les numéros des flèches sont sur le cadre, en portrait comme en paysage, et les pions de l'ordinateur sont lisibles partout.
Tutoriel (accueil-tutoriel-aide.md) :
- deux flèches circulaires, claire et sombre, dessinées sous les pions, à la place du tracé en pointillés ;
- les textes des étapes 2, 5, 6 et 7 emploient les jans (« votre jan intérieur, les flèches 1 à 6 ») ;
- une section « Vocabulaire : les jans » fixe les quatre noms et demande deux fiches de glossaire.
Palette blanc et noir : pas adoptée ici. Pierre n'est pas sûr (« je ne sais pas pour les couleurs »). Les deux palettes sont comparées sur le canevas (https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe, rangée « Retours des premiers joueurs »), avec le nouveau contour, pour qu'il choisisse sur pièces.

Comment

Le contour clair a été choisi par calcul de contraste plutôt qu'en éclaircissant les pions eux-mêmes : le pion reste sombre, ce qui garde l'opposition des deux camps, et seul son bord se détache de son fond.

Choix et compromis

Le mot « camp » disparaît des textes, au profit des jans, qui sont le vocabulaire du jeu.
Le changement de palette attend la décision de Pierre ; il ne touche pas au logo.

Risques et déploiement

Aucun : il n'y a que de la documentation. Pour revenir en arrière, il suffit d'annuler le commit de fusion.

Comment vérifier

make lint
make test

Hors périmètre

L'implémentation dans l'app, faite par la session de développement.
Les fiches du glossaire jan intérieur et jan extérieur.
Le choix de palette.

Generated with Claude Code (https://claude.com/claude-code)

## Pourquoi Les premiers joueurs ont donné leurs retours à Pierre le 2026-11-11 (« C'est vraiment pas mal, ça avance bien »), avec quatre demandes : - les numéros des flèches à l'extérieur du plateau ; - parler des jans pour simplifier les explications ; - des pions blancs et noirs plutôt qu'ivoire et ébène ; - deux flèches circulaires, blanche et noire, pour montrer le sens du jeu dans le tutoriel. Pierre ajoute que le vrai problème est qu'« on voit mal les pions sombres sur la barre ». C'est confirmé par le calcul : le contour noir des pions sombres a un contraste proche de 1:1 avec la barre en noyer, et en thème sombre les pions sombres se détachent mal du plateau. ## Quoi - **Pions sombres lisibles** : le contour et le filet des pions de l'ordinateur (checker-computer-edge) deviennent clairs (#B8AC98) dans les deux thèmes. Ils se détachent sur la barre, sur les flèches sombres et en thème sombre. - **Recette** (recette-ux.md), deux règles nouvelles : les numéros des flèches sont sur le cadre, en portrait comme en paysage, et les pions de l'ordinateur sont lisibles partout. - **Tutoriel** (accueil-tutoriel-aide.md) : - deux flèches circulaires, claire et sombre, dessinées sous les pions, à la place du tracé en pointillés ; - les textes des étapes 2, 5, 6 et 7 emploient les jans (« votre jan intérieur, les flèches 1 à 6 ») ; - une section « Vocabulaire : les jans » fixe les quatre noms et demande deux fiches de glossaire. - **Palette blanc et noir** : pas adoptée ici. Pierre n'est pas sûr (« je ne sais pas pour les couleurs »). Les deux palettes sont comparées sur le canevas (https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe, rangée « Retours des premiers joueurs »), avec le nouveau contour, pour qu'il choisisse sur pièces. ## Comment Le contour clair a été choisi par calcul de contraste plutôt qu'en éclaircissant les pions eux-mêmes : le pion reste sombre, ce qui garde l'opposition des deux camps, et seul son bord se détache de son fond. ## Choix et compromis - Le mot « camp » disparaît des textes, au profit des jans, qui sont le vocabulaire du jeu. - Le changement de palette attend la décision de Pierre ; il ne touche pas au logo. ## Risques et déploiement Aucun : il n'y a que de la documentation. Pour revenir en arrière, il suffit d'annuler le commit de fusion. ## Comment vérifier make lint make test ## Hors périmètre - L'implémentation dans l'app, faite par la session de développement. - Les fiches du glossaire jan intérieur et jan extérieur. - Le choix de palette. Generated with Claude Code (https://claude.com/claude-code)

pierre added 1 commit 2026-11-11 21:00:44 +00:00

Charte : retours des premiers joueurs (pions sombres lisibles, numéros sur le cadre, jans, flèches circulaires) 22e415bb81

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

pierre merged commit 6a1ee6f65a into main

2026-11-11 21:00:45 +00:00

pierre referenced this pull request

2026-11-11 21:14:55 +00:00

Identité : pions blancs et noirs avec contour (ADR 0010 amendé) #55

pierre referenced this pull request

2026-11-12 02:35:55 +00:00

Retours des premiers joueurs : pions blancs et noirs, numéros sur le cadre, flèches du tutoriel, jans #58

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: pierre/Ustagammon#54