[numpy] Corrections de style et de terminologie - #24
Conversation
|
Merci Emile — this is exactly the review the edition needed. We validated the PR sentence-by-sentence against the English source (fidelity, French quality, and technical integrity, each independently double-checked): zero regressions across 53 changes, all 109 code cells byte-identical, MyST structure intact. The calque repairs are the standout — « droits égaux », « choquant pour les programmeurs MATLAB », the stranded « de » before the numbered list — and a few edits improve on the English itself (the row/column ordering now matches the code cells that follow). Recommendation is to merge. Your duplicated Four small things before or just after merge, none blocking:
Also encoded from this PR into the translation engine (so future syncs produce text closer to yours): |
…que rules + glossary v1.1 (#241) * feat(fr): encode the first native-editor review — 4 register/anti-calque rules + glossary v1.1 Encodes Emile's (@Honaminto) hand-review of two machine-seeded lectures (QuantEcon/lecture-python-programming.fr#24 and #25, ~80 corrections, independently validated at 0 regressions on numpy.md) as engine rules, following the ml packet pattern from #237: every correction made at least twice becomes a prompt rule, every explicit terminology ruling becomes a glossary pin. Glossary v1.1 (+3): Flat array / One-dimensional array -> Tableau unidimensionnel; Boolean mask -> Masque booléen. Not pinned, per the #78 bar: no-variation terms, the context-dependent package/bibliothèque call, and Lecture -> Chapitre (his edits are mixed and 24 seeded lectures say cours — going back to the editor as a question). fr additionalRules 2 -> 6: impersonal academic register, no calqued discourse formulas, translate descriptive math/comment symbols but never code identifiers, natural French sentence structure over mirrored English. Rules feed review mode too — validate on the harness before release. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(fr): gate the comment-symbol clause on the code-comments localization rule Copilot review on #241: rule 3 instructed descriptive-symbol translation in code comments unconditionally, conflicting with the base keep-code-as-is prompt rules — comment translation is architecturally the opt-in code-comments localization rule. The clause now scopes to display math and hints, extending into comments only where that rule is active. Docs and changelog mirrored. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Summary
I went through numpy.md sentence by sentence, comparing it with the English version. In total I made 53 changes in the file, almost all style fixes to make the French read more naturally, plus one small bug fix.
What I changed
Most of my changes fix sentences that stuck too close to the English wording and sounded a bit forced in French. For example, I reworded phrases like "les tableaux disposent de méthodes utiles, toutes soigneusement optimisées" so it sounds more natural.
A few specific things:
What I intentionally left alone
A few suggestions I didn't apply, because they either changed the technical meaning of the text or would have created inconsistency with terminology used elsewhere in the file. I also noticed a small mismatch between the text (which mentions tic/toc) and the code (which uses qe.Timer), but that comes from the English version, so I'll flag it as a separate issue instead of fixing it directly in the code.