Charte : accueil, installation, tutoriel, aide #30

2026-11-03T13:58:26Z

pierre commented

2026-11-03 13:58:26 +00:00

Pourquoi

La session de développement prépare l'étape 0e.5 (qui rejoint 1g pour le tutoriel). Pierre y a demandé quatre choses :

une page d'accueil ;
l'installation en un toucher, proposée par l'app elle-même ;
un tutoriel des règles « TRÈS DIDACTIQUE », avec de belles visualisations du plateau ;
une aide plus humaine que l'actuelle, qu'il trouve « pas très humaine » parce qu'elle affiche les scénarios Gherkin et le glossaire bruts.

La session de développement a demandé à la session design les maquettes et les règles correspondantes avant d'implémenter.

Quoi

docs/identite/charte/accueil-tutoriel-aide.md couvre les quatre sujets :

Accueil : un choix au premier lancement (« Je découvre » ou « Je connais les règles ») ; ensuite, la partie en cours, la prochaine leçon et la progression résumée en une ligne.
Installation : proposée après la première partie terminée, jamais pendant le jeu, une seule relance. Sous Chrome, l'invite du système passe par beforeinstallprompt ; sous Firefox et sur iPhone, une feuille en trois étapes. Plus rien une fois l'app installée.
Tutoriel : huit étapes en écrans courts, des écrans « à vous » contrôlés par le moteur, des pions qui bougent, et une première version complète du texte, à valider par Pierre.
Aide : trois onglets. Chaque scénario devient une question repliable. Le titre du scénario est la question, sa description est la réponse, et les étapes Gherkin restent cachées : ce sont les tests (ADR 0008).

Les maquettes sont sur https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe (rangée « Étape 0e.5 » et artboard « Accueil »).

Comment

Les positions illustrées passent par les identifiants gnubg (ADR 0013), et aucune règle n'est codée hors du moteur : un écran « à vous » demande au moteur si le coup du joueur est l'un des coups attendus. Les positions des maquettes ont été vérifiées : quinze pions par camp, flèches d'entrée libres, comptes de points recalculés.

Choix et compromis

Pas de proposition d'installation au premier lancement : c'est trop tôt, le joueur n'a encore rien vu de l'app.
Pas de chiffres d'erreur sur l'accueil.
Les étapes Gherkin ne sont pas montrées dans l'aide, mais restent dans les fichiers : la source reste unique.
Le texte du tutoriel utilise le mot « camp ». Il faudra ajouter sa fiche au glossaire.

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 (session de développement) et la validation des textes par Pierre.

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

## Pourquoi La session de développement prépare l'étape 0e.5 (qui rejoint 1g pour le tutoriel). Pierre y a demandé quatre choses : - une page d'accueil ; - l'installation en un toucher, proposée par l'app elle-même ; - un tutoriel des règles « TRÈS DIDACTIQUE », avec de belles visualisations du plateau ; - une aide plus humaine que l'actuelle, qu'il trouve « pas très humaine » parce qu'elle affiche les scénarios Gherkin et le glossaire bruts. La session de développement a demandé à la session design les maquettes et les règles correspondantes avant d'implémenter. ## Quoi docs/identite/charte/accueil-tutoriel-aide.md couvre les quatre sujets : - **Accueil** : un choix au premier lancement (« Je découvre » ou « Je connais les règles ») ; ensuite, la partie en cours, la prochaine leçon et la progression résumée en une ligne. - **Installation** : proposée après la première partie terminée, jamais pendant le jeu, une seule relance. Sous Chrome, l'invite du système passe par beforeinstallprompt ; sous Firefox et sur iPhone, une feuille en trois étapes. Plus rien une fois l'app installée. - **Tutoriel** : huit étapes en écrans courts, des écrans « à vous » contrôlés par le moteur, des pions qui bougent, et une première version complète du texte, à valider par Pierre. - **Aide** : trois onglets. Chaque scénario devient une question repliable. Le titre du scénario est la question, sa description est la réponse, et les étapes Gherkin restent cachées : ce sont les tests (ADR 0008). Les maquettes sont sur https://claude.ai/artifact/CQw6vbDpi6XQqVWQa4sANe (rangée « Étape 0e.5 » et artboard « Accueil »). ## Comment Les positions illustrées passent par les identifiants gnubg (ADR 0013), et aucune règle n'est codée hors du moteur : un écran « à vous » demande au moteur si le coup du joueur est l'un des coups attendus. Les positions des maquettes ont été vérifiées : quinze pions par camp, flèches d'entrée libres, comptes de points recalculés. ## Choix et compromis - Pas de proposition d'installation au premier lancement : c'est trop tôt, le joueur n'a encore rien vu de l'app. - Pas de chiffres d'erreur sur l'accueil. - Les étapes Gherkin ne sont pas montrées dans l'aide, mais restent dans les fichiers : la source reste unique. - Le texte du tutoriel utilise le mot « camp ». Il faudra ajouter sa fiche au glossaire. ## 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 (session de développement) et la validation des textes par Pierre. Generated with Claude Code (https://claude.com/claude-code)

pierre added 1 commit 2026-11-03 13:58:27 +00:00

Charte : accueil, installation, tutoriel des règles, aide en questions f24315fb98

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

pierre merged commit 31159a5707 into main

2026-11-03 13:58:28 +00:00

pierre referenced this pull request

2026-11-03 14:02:14 +00:00

Plan 0e.5 : accueil, installation, tutoriel, aide #31

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: pierre/Ustagammon#30