Projet

Général

Profil

Fonctionnalité #2023

ouvert

Documentation utilisateur

Fonctionnalité #2023: Documentation utilisateur

Ajouté par Damien Cuvillier il y a environ un mois. Mis à jour il y a 3 jours.

Statut:
A mettre en production
Priorité:
Normal
Assigné à:
-
Début:
07/10/2026
Echéance:
% réalisé:

100%

Temps estimé:

Description

Crée une documentation wiki (prêt pour le sync-redmine) pour les utilisateurs avec des captures d'écrans sur les grands use cases 

  • installation et autorisation MacOS
  • usage principal 
  • configuration des navigateurs
  • configuration des raccourcis
  • se souvenir du choix 

En FR/EN/DE/ES/PT/IT

Page par défaut pointe vers les différentes documentation localisée (avec drapeaux)


Fichiers

claude-session-2023.glog (3,21 Mo) claude-session-2023.glog Damien Cuvillier, 07/10/2026 17:08
claude-session-2023.glog (5,39 Mo) claude-session-2023.glog Damien Cuvillier, 07/10/2026 17:34

Mis à jour par Damien Cuvillier il y a environ un mois Actions #1

  • % réalisé changé de 0 à 10

Mis à jour par Damien Cuvillier il y a environ un mois Actions #2

  • Statut changé de À prioriser à En cours
  • % réalisé changé de 10 à 20

Mis à jour par Damien Cuvillier il y a environ un mois Actions #3

  • % réalisé changé de 20 à 30

Mis à jour par Damien Cuvillier il y a environ un mois Actions #4

  • % réalisé changé de 30 à 40

Mis à jour par Damien Cuvillier il y a environ un mois Actions #5

  • % réalisé changé de 40 à 50

Mis à jour par Damien Cuvillier il y a environ un mois Actions #6

  • % réalisé changé de 50 à 60

Mis à jour par Damien Cuvillier il y a environ un mois Actions #7

  • % réalisé changé de 60 à 70

Mis à jour par Damien Cuvillier il y a environ un mois Actions #8

Synthèse de la session Claude Code :

Je commence par la convention wiki/redmine du framework et l'existant.

Une doc wiki existe déjà en 8 langues. Je l'inspecte avant d'écrire.

La doc existe en 8 langues, thématique, avec des emplacements de captures en attente. Le sync Redmine téléverse les images référencées — il me faut donc de vraies captures. Je teste ce qui est possible.

Captures d'écran système impossibles ici (TCC refuse l'accès au display). Je vais les produire par rendu hors écran des vues réelles, comme le fait déjà --diagnose. J'inspecte les vues à rendre.

Pas de capture système possible. Je rends donc les vraies vues hors écran via ImageRenderer, derrière un drapeau caché comme --diagnose. Je regarde les signatures des panneaux à rendre.

Le rendu ImageRenderer ne saurait pas rendre les listes AppKit (List, TabView). Je passe par une fenêtre hors écran + cacheDisplay, qui capture la vraie hiérarchie. Je lis le contrôleur de palette pour reproduire son montage.

Je crée le module de captures et le point d'entrée.

Je prépare une configuration de démonstration jetable (sans toucher celle de l'utilisateur) et je lance une première capture en français.

Cinq navigateurs installés : la machine se prête bien aux captures. Je crée la configuration de démonstration et je lance la première prise.

Six captures produites. Je les contrôle visuellement.

Le rendu fonctionne. Deux correctifs : lancer depuis le bundle (sinon les traductions ne se chargent pas) et masquer les applications non pertinentes. Je liste d'abord les gestionnaires http de la machine.

La capture est bonne. Mais elle révèle une clé non traduite — picker.hint.search. Je vérifie.

Le bundle de référence est périmé — je l'assemble à partir des ressources du dépôt.

La capture révèle bien mes ajouts (icônes de thème, badge « TEXTE INTÉGRAL »), mais cacheDisplay ne peint ni le fond de fenêtre ni la barre d'onglets. Je rends les panneaux seuls, sur fond opaque et en apparence claire.

Impeccable. Je contrôle les trois autres.

Deux correctifs : contraindre la taille des panneaux, et présélectionner une règle pour que l'éditeur soit visible.

Je regroupe la prise de vue dans un script, et je génère les six langues.

Le filtrage de langues bute sur set -e. Je le réécris.

Je corrige le jeu de démonstration (domaine tronqué dans l'éditeur), puis je génère les six langues.

36 captures générées (~4,6 Mo). Je vérifie une langue autre que le français.

Les captures sont bonnes dans toutes les langues. Je lis les pages existantes pour m'accorder au style avant de rédiger.

Les captures remplacent les 5 emplacements déjà balisés. Je rédige maintenant les pages, en commençant par le français.

Je remplace les emplacements de captures dans les 6 langues, avec un texte alternatif traduit.

J'ajoute aux index localisés un sommaire par cas d'usage. Je regarde la structure de l'anglais pour aligner les six.

Je rédige les trois pages dans les cinq autres langues.

Allemand :

Espagnol :

Portugais :

Italien :

Les 18 pages sont écrites. J'ajoute maintenant le sommaire par cas d'usage dans les six index localisés.

Aucun lien ni image manquants. J'étends les captures au japonais et au chinois pour que les cinq emplacements restants ne soient plus des placeholders.

Capture japonaise correcte. Je refonds la page racine : une ligne par langue, drapeau et lien.

67 pages, 48 captures, aucun lien mort. J'ajoute la note au README et je relance la vérification complète.

Mis à jour par Damien Cuvillier il y a environ un mois Actions #9

  • % réalisé changé de 70 à 10

le lien vers le doc depuis l'application doit prendre en compte le path de la langue

Mis à jour par Damien Cuvillier il y a environ un mois Actions #10

  • Statut changé de À Tester à En cours
  • % réalisé changé de 10 à 20

Mis à jour par Damien Cuvillier il y a environ un mois Actions #11

  • % réalisé changé de 20 à 30

Mis à jour par Damien Cuvillier il y a environ un mois Actions #12

  • % réalisé changé de 30 à 40

Mis à jour par Damien Cuvillier il y a environ un mois Actions #13

  • % réalisé changé de 40 à 50

Mis à jour par Damien Cuvillier il y a environ un mois Actions #14

  • % réalisé changé de 50 à 60

Mis à jour par Damien Cuvillier il y a environ un mois Actions #15

  • % réalisé changé de 60 à 70

Mis à jour par Damien Cuvillier il y a environ un mois Actions #16

Synthèse de la session Claude Code :

Je commence par la remarque du test. Je regarde le lien d'aide actuel et ce que le wiki expose réellement.

Le lien construit …/wiki/fr. Je vérifie comment le sync nomme réellement ces pages — c'est lui qui fait foi.

Le sync qualifie les titres en cas de collision. Je fais tourner son propre algorithme sur doc/wiki pour connaître les titres réels.

Les sous-pages sont bien préfixées par la langue (fr_install, fr_picker), l'index de langue restant fr. Je vérifie ce que répond le wiki déployé.

Redmine peut répondre 200 sur une page absente. Je calibre avec une page sûrement inexistante, puis j'inspecte le contenu.

Le wiki est déjà synchronisé et /wiki/fr répond. Je cherche tous les liens vers la doc, dans l'application comme dans le site.

Voilà le défaut : le site, pourtant multilingue, envoie ses quatre liens « Documentation » vers la racine du wiki. Et l'application sait viser la langue mais pas une page précise — où le préfixe de langue est obligatoire. Je corrige les deux, en partant de l'application.

Je vérifie que les URLs produites par l'application existent réellement sur le wiki, pour chaque langue et chaque page.

Les 60 adresses possibles répondent. Je corrige maintenant les liens du site, qui ignoraient la langue.

Je vérifie dans les pages construites que chaque langue pointe bien vers sa propre documentation.

Je complète le diagnostic avec l'adresse d'aide — utile au support, et cela me permet de vérifier l'application en conditions réelles.

Le diagnostic s'écrit dans le dossier réel de l'utilisateur, HOME étant ignoré par macOS. Je lis donc le bon chemin pour terminer la vérification.

Toutes les langues tombent juste. Un piège subsiste : les pages de cas d'usage n'existent qu'en six langues, alors que la doc couvre huit dossiers. Je prémunis l'application contre un lien mort.

Je vérifie la vérification complète : build, site, et l'ensemble des adresses atteignables.

Mis à jour par Damien Cuvillier il y a 3 jours Actions #17

  • Statut changé de À Tester à A mettre en production
  • % réalisé changé de 70 à 100

Formats disponibles : PDF Atom