Skip to content

CI: check-style + nettoyage TRADUCTIONS.txt#2545

Merged
lacatoire merged 8 commits into
php:masterfrom
lacatoire:ci/check-style-fr
Feb 25, 2026
Merged

CI: check-style + nettoyage TRADUCTIONS.txt#2545
lacatoire merged 8 commits into
php:masterfrom
lacatoire:ci/check-style-fr

Conversation

@lacatoire
Copy link
Copy Markdown
Member

@lacatoire lacatoire commented Feb 25, 2026

Ajout d'un workflow CI qui vérifie les règles de style de TRADUCTIONS.txt sur les fichiers XML modifiés dans chaque PR, et nettoyage de toutes les violations existantes.

Fonctionnement

Le script .github/scripts/check-style-fr.mjs lit dynamiquement les règles depuis TRADUCTIONS.txt. Toute ligne au format :

INTERDIT : "texte interdit" → "remplacement"

devient automatiquement une règle de CI. Aucune règle n'est codée en dur dans le script.

Règles actuelles (19)

Toutes bloquent la CI :

  • Style impersonnel : Vous pouvez/devez/devriez, votre, vos, assurez-vous, reportez-vous, référez-vous, Notez que
  • Français : etc..., comme par exemple, si il, optionel, abrévier, chiffrage
  • Terminologie : librairie, encryption, decrypter
  • Versionnage : depuis PHP x.y

Nettoyage

371 violations existantes corrigées dans ~240 fichiers.

Autres changements

  • Harmonisation des noms de workflows (.yaml.yml, noms cohérents)
  • Restructuration de TRADUCTIONS.txt avec le format INTERDIT : parsable

Inspiré de doc-ja (textlint + prh).

Checks changed XML files in PRs for:
- Direct address forms (vous/votre/vos) → warnings
- French grammar errors (etc..., comme par exemple, si il) → errors
- Incorrect terminology (librairie, chiffrage, encryption) → warnings

Inspired by doc-ja's textlint+prh approach but simpler:
runs directly on XML sources, no PhD render needed.

Only errors (grammar/spelling) fail the CI.
Style warnings appear as PR annotations without blocking.
- 174x "Notez que" → "Il est à noter que"
- 50x "depuis PHP X" → "à partir de PHP X"
- 50x "votre" → le/la/du
- 15x "si il" → "s'il"
- 14x "Vous pouvez" → "Il est possible de"
- 14x "encryption" (faux positifs entity refs exclus)
- 12x "assurez-vous" → "il faut s'assurer"
- 12x "Vous devez" → "Il faut"
- 11x "vos" → les/des
- 9x "comme par exemple" → "par exemple"
- 6x "Vous devriez" → "Il est recommandé de"
- 2x "optionel" → "optionnel"
- 2x "reportez-vous" → "se reporter"

Toutes les règles passent désormais en erreur dans la CI.
- integrate.yaml → build.yml (extension + nom cohérent)
- check-style-fr.yml → check-style.yml ("-fr" redondant)
- Aligner les noms de workflow et job
Le script parse TRADUCTIONS.txt au démarrage et génère les règles
de vérification automatiquement. Plus aucune règle en dur.
Le script CI lit les lignes INTERDIT de TRADUCTIONS.txt pour générer
les règles de vérification. Plus aucune règle en dur dans le script.
Corrige les 27 violations restantes (Depuis PHP → À partir de PHP).
@lacatoire lacatoire changed the title CI: add French style checker (TRADUCTIONS.txt) CI: check-style + nettoyage TRADUCTIONS.txt Feb 25, 2026
@lacatoire lacatoire merged commit 2d314f7 into php:master Feb 25, 2026
3 checks passed
@lacatoire lacatoire deleted the ci/check-style-fr branch February 25, 2026 12:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant