pdulvp.fr

Réécriture en français simple des commentaires et du texte des règles has been fixed.

See more details at : https://github.com/pdulvp/pdcartes-rami/issues/16

  • commentaires des 67 fichiers de src/ réécrits en français standard et

descriptif : métaphores filées, formules et apartés remplacés par des
phrases décrivant ce que fait le code, en conservant les justifications

  • texte intégral des règles affiché par HelpDialog repris de même, et deux

fautes corrigées : « dans la même tour » pour « le même tour », et une
phrase dont le sujet changeait en cours de route

Rami.h étaient en anglais, et plusieurs fichiers changeaient de langue au
milieu d'un même commentaire

de la déclaration d'appIcon, les deux blocs s'étant retrouvés accolés ;
chacun est remis devant la fonction qu'il décrit

  • aucune modification de code : le diff ne porte que sur des commentaires et

sur le texte des règles

Passe globale sur les commentaires de src/

<sub>2026-10-25-1230-passe-globale-sur-les-commentaires-des-sources.md — 2026-10-25 12:30</sub>

Les commentaires du projet sont écrits dans un style imagé : métaphores
filées (le drap, l'enseigne, la maison), formules construites pour l'effet,
phrases longues où l'information technique est noyée. L'auteur signale que le
code en est devenu difficile à lire.

Il s'agit de réécrire ces commentaires en français standard et descriptif.
67 fichiers, environ 2 900 lignes de commentaire sur 15 000 lignes au total.

Décisions

règles affichées par HelpDialog sont de la documentation destinée au
joueur et relèvent de la même demande. La bibliothèque
cartes-set-creator/lib est un autre dépôt et n'est pas touchée. Les plans
archivés non plus.

  • Les commentaires sont unifiés en français. Plusieurs fichiers sont

rédigés en anglais (Cards.h), et certains changent de langue au milieu
d'une phrase : « Le tapis : the cloth, with the light falling on the middle
of it ». Ce mélange est à lui seul une cause d'illisibilité. La langue de
travail du projet étant le français, tout est ramené au français.

  • Les fautes relevées dans le texte des règles sont corrigées. « dans la

même tour » pour « le même tour », et une phrase dont le sujet change en
cours de route (« il doit servir tout de suite [...] le posera ou le mettra
au bout »).

  • Aucune modification de code. Seules changent les lignes de commentaire.

Vérifié par filtrage du diff après chaque lot, et par une compilation des
deux cibles à la fin.

  • L'information est conservée, pas résumée. Ces commentaires expliquent

souvent pourquoi une solution a été retenue, parfois après un essai
infructueux. Cette justification est la partie utile et doit survivre à la
réécriture ; c'est la formulation qui change, non le contenu.

  • Les noms propres du domaine sont conservés. « tapis », « dos »,

« manche », « pioche », « adversaire » sont le vocabulaire du jeu, pas des
métaphores, et ils figurent dans l'interface. En revanche « le drap » pour
le tapis, « l'enseigne » pour le logo ou « la maison » pour l'application
sont remplacés par le terme direct.

  • Traitement par lots, par sous-système. L'ordre suit le découpage déjà

inscrit dans CMakeLists.txt, ce qui permet de garder le vocabulaire
cohérent d'un fichier à l'autre.

Règles appliquées

  • décrire ce que fait le code, sans métaphore ni formule ;
  • une idée par phrase ; supprimer les apartés au lecteur ;
  • sujet explicite, accords et prépositions corrects ;
  • espace avant : ; ? !, guillemets « » ;
  • conserver les renvois aux identifiants entre backticks.

Étapes

  1. [x] Cartes et rendu : Cards, CardArt, DrawnDeck, TitleMark,

Fonts, TileButton, ProfileChip, MenuStyle.

  1. [x] Règles : Melds, Tables, TableLook, Rami.
  2. [x] Adversaires : RivalSkills, Rivals, Profiles, Brain, Arene.
  3. [x] Écran titre et table : TitlePage, TitleFlight, TableView,

TablePage, ScoreBoard, VictoryEffect.

  1. [x] Menu et boîtes : MainWindow, RivalCard, RivalSheet,

RivalGlance, SkillRow, TablePicker, SettingsDialog,
AskDialog, NameDialog, main, Version.

  1. [x] HelpDialog : les commentaires, puis le texte des règles.
  2. [x] Bâtir en série des deux côtés ; vérifier qu'aucune ligne de code n'a

changé, et relire les règles rendues hors écran.

Vérifié

Les 67 fichiers de src/ sont traités, plus le texte des règles.

Compilation Linux en série après chaque groupe de fichiers : aucune erreur.
En fin de passe, les trois cibles sont bâties — pdcartes-rami,
pdcartes-rami-arene et le binaire Windows — et les deux paquets produits.

Aucune ligne de code n'a changé : le filtrage du diff ne fait apparaître que
des commentaires, des commentaires de fin de ligne dont la partie code est
intacte, et les lignes du texte des règles.

Plus aucun commentaire n'est en anglais. Le seul fichier que le contrôle
signale encore, TitleFlight.h, est un faux positif : ses paramètres
s'appellent from et to.

Le texte des règles est analysé après réécriture : aucune balise non fermée,
aucune balise fermante inattendue, 8 351 caractères.

Le filtrage du diff ne signale que des commentaires de fin de ligne, dont la
partie code est inchangée, et les lignes du texte des règles.

Deux défauts relevés et corrigés au passage :

de la déclaration d'appIcon, les deux blocs s'étant retrouvés accolés.
Chaque commentaire est remis devant la fonction qu'il décrit.

  • texte des règles : « dans la même tour » pour « le même tour », et une

phrase dont le sujet changeait en cours de route (« il doit servir tout de
suite [...] le posera ou le mettra au bout »), réécrite à la deuxième
personne comme le reste du paragraphe.

<sub>Filed by prel from the completed plans at commit time.</sub>