QuantEcon / QuantEcon/lecture-python-programming.fr
French translation review — native-speaker read-through (project tracker)
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 0
- Forks
- 1
- Ø Merge
- 41 Min.
- Gemergte PRs (30 T.)
- 3
Beschreibung
Tracker for the native-speaker review of the French edition by @Honaminto. It replaces #3, whose 26-box checklist could not be ticked by its reviewer (read access only) and which is closed in favour of this project — see the decision on project-translation#19.
Background
This repository is a machine-generated first draft of the QuantEcon Python Programming lectures in French (Claude Opus 4.8, one pass, 364-term glossary, no human edits). The precedent that matters: the Persian review found meaning-inverting mistranslations that read perfectly fluently. A native reading is the only thing that catches those. There is no deadline — one lecture a month is genuinely useful.
Where we stand (verified 2026-08-21)
| Fact | State |
|---|---|
| Lectures in the ToC | 27 (polars.md was added after #3 was opened, which listed 26) |
| Reviewed so far | 2 — numpy.md (#24) and python_by_example.md (#25), Emile's edits merged 2026-08-04 |
| Reviewer's access | write pending — added to translation-team-french (push) on 2026-08-21, awaiting his acceptance of the invitation; was read before, contrary to what #3 said |
| Roster | .translate/config.yml names editors.primary: Honaminto |
| Glossary questions | the six in action-translation#78 (merged 2026-07-22 "review needed") are unanswered; Cours vs chapitre deliberately deferred in action-translation#241 |
How the review works
One sub-issue per lecture, below. Each is complete when a PR editing that lecture by @Honaminto is merged, or when he approves the lecture as needing no change — nothing is ticked by hand; the PR is the record. Edit the French directly (a branch in this repo, one PR per lecture), or leave line comments / suggestion blocks on a PR if that is easier. Priorities, in order: meaning errors; wrong technical terms; inconsistent terminology; unnatural French (academic register); anything in code comments that looks wrong. Please ignore spacing before : ; ! ? (fixed automatically, action-translation#81), errors in the English (raise upstream), and the translation: header block. A term that is wrong is probably wrong in several lectures — say so on the terminology sub-issue and it goes into the glossary once, for every lecture.
Work plan
| Phase | Issue | Work item |
|---|---|---|
| 0 — access | #41 | @Honaminto accepts the team invitation (write) and acknowledges the editor agreement |
| 0 — terminology | #42 | Decision: the seven open glossary questions (six from QuantEcon/action-translation#78 + Cours vs chapitre) |
| 1 — lectures | #43 | Review intro.md |
| 1 — lectures | #44 | Review about_py.md |
| 1 — lectures | #45 | Review getting_started.md |
| 1 — lectures | #46 | Review python_by_example.md — done: fr#25 merged 2026-08-04 |
| 1 — lectures | #47 | Review functions.md |
| 1 — lectures | #48 | Review python_essentials.md |
| 1 — lectures | #49 | Review oop_intro.md |
| 1 — lectures | #50 | Review names.md |
| 1 — lectures | #51 | Review python_oop.md |
| 1 — lectures | #52 | Review need_for_speed.md |
| 1 — lectures | #53 | Review numpy.md — done: fr#24 merged 2026-08-04 |
| 1 — lectures | #54 | Review matplotlib.md |
| 1 — lectures | #55 | Review scipy.md |
| 1 — lectures | #56 | Review numba.md |
| 1 — lectures | #57 | Review jax_intro.md |
| 1 — lectures | #58 | Review numpy_vs_numba_vs_jax.md |
| 1 — lectures | #59 | Review autodiff.md |
| 1 — lectures | #60 | Review pandas.md |
| 1 — lectures | #61 | Review pandas_panel.md |
| 1 — lectures | #62 | Review polars.md |
| 1 — lectures | #63 | Review writing_good_code.md |
| 1 — lectures | #64 | Review workspace.md |
| 1 — lectures | #65 | Review python_advanced_features.md |
| 1 — lectures | #66 | Review debugging.md |
| 1 — lectures | #67 | Review sympy.md |
| 1 — lectures | #68 | Review troubleshooting.md |
| 1 — lectures | #69 | Review status.md |
Phase 0 gates nothing technically — Emile can already open PRs from a fork, as #24/#25 show — but accepting the invitation is what makes in-repo branches and one-click suggestions work, and the terminology decision improves every unreviewed lecture at once, so both come first. Phase 1 runs in any order; intro.md and about_py.md are the most-read after the two already done. The two reviewed lectures are filed as sub-issues and closed immediately so the progress bar reflects work that has actually happened.
What does not need to change
The translations are not re-generated during the review. Glossary changes from Phase 0 flow into future syncs automatically; they are not back-applied to reviewed lectures by machine.
Sources
#3 (superseded), project-translation#19 (decision, 2026-08-21), plans/human-reviews.md WS5 (nominated audits, derived status). Repo state verified at main on 2026-08-21.
Merci beaucoup, Emile — questions and disagreement are very welcome.
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit .translate/config.yml und den Phase-0-Unteraufgaben #41 und #42, um die Entscheidungen zu Zugriff und Terminologie zu verstehen. Wähle für Review-Arbeiten eine offene Vorlesungs-Unteraufgabe aus und lies ihre genannte .md-Datei, wobei du die angegebenen Review-Prioritäten befolgst. Als erledigt gilt die Aufgabe, wenn ein PR, der diese Vorlesung bearbeitet, gemergt wird oder der Reviewer ihn ohne Änderungen genehmigt.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Aktiv
- Klarheit
- Klar beschrieben
- Anfängerfreundlichkeit
- 38/100