Malayalam translation: python_by_example — native-speaker calibration review

[mmcky]

Machine translation of python_by_example for native-speaker review — Phase 2 of QuantEcon/action-translation#189. Merging this PR lands the translation including any fixes committed during review, so review comments here improve the real site directly.

For the reviewer: please comment on any line you would change — English that should be Malayalam, Malayalam that should be English, a wrong case-suffix, awkward phrasing, or the same term handled differently in two places. Headings, code cells and transliteration are already machine-verified (all headings byte-identical, code untouched, zero transliterations) — no need to proofread those. Every comment resolves to exactly one of: a glossary entry, a rule change in the translation tool, or accepted-as-is with our reasoning replied on the thread.

Provenance: source QuantEcon/lecture-python-programming@5816589 · model claude-sonnet-5 · action-translation@main with the register rules + glossary v0.2.0 derived from the reviewer packet · produced by harness run https://github.com/QuantEcon/test-translation-sync/actions/runs/30783362693 and adopted here byte-exact.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds the Malayalam machine translation of the python_by_example lecture for native-speaker calibration review (Phase 2 of QuantEcon/action-translation#189), landing the translated content directly into the site.

Changes:

• Introduces a new lectures/python_by_example.md MyST/Jupytext lecture file containing the Malayalam translation.
• Includes translation metadata (translation: block) for title/headings mapping.

Suppressed comments (3)

lectures/python_by_example.md:357

• "etc.-ന്" mixes English filler with Malayalam case-suffix; replacing with a Malayalam equivalent avoids the awkward hyphenation and reads more naturally.

വാസ്തവത്തിൽ, Python-ൽ, *എല്ലാ* code blocks-ഉം (അതായത്, loops, if clauses, function definitions, etc.-ന് അകത്ത് സംഭവിക്കുന്നവ) indentation-ൽ delimit ചെയ്യപ്പെടുന്നു.

lectures/python_by_example.md:372

• This nested bullet uses the English filler "etc." (with a trailing space). Consider replacing it with a Malayalam equivalent.

    * etc. 

lectures/python_by_example.md:280

• This Malayalam translation still uses the English filler "etc."; consider replacing it with a Malayalam equivalent for consistency.

* String objects-ന് [string methods](https://docs.python.org/3/library/stdtypes.html#string-methods) ഉണ്ട്, list objects-ന് [list methods](https://docs.python.org/3/tutorial/datastructures.html#more-on-lists) ഉണ്ട്, etc.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mmcky]

A note on the automated comments above — they are not from our translation tool, and none of them needs your attention.

GitHub Copilot reviews every pull request in this organisation automatically. It is a general-purpose code reviewer with no knowledge of this edition's translation policy, so on a Malayalam lecture it mostly argues against the policy — repeatedly suggesting that technical terms kept in English should be rendered in Malayalam. That is exactly the over-translation this edition is designed to avoid, and in one case it proposed replacing recommend ചെയ്യുന്നു with ശുപാർശ ചെയ്യുന്നു, which inverts the light-verb rule you specified.

We have checked every one of its comments against the English source and replied to each on its own thread, then marked them resolved so they collapse out of your view. The breakdown for this lecture:

Copilot's comments	What we found
1 comment	A real markup problem (triple backticks used for inline code) that is present verbatim in the English source — filed upstream as QuantEcon/lecture-python-programming#602
1 comment, plus 3 it suppressed	Asks for etc. and similar retained English to be translated — contrary to the keep-English policy

None of its comments identified a translation defect.

What we are asking you for is unchanged: comment on any line you would change — English that should be Malayalam, Malayalam that should be English, a wrong case-suffix, awkward phrasing, or the same term handled differently in two places. Yours is the review that counts here; please disregard the collapsed automated threads entirely.

[github-actions]

📖 HTML build - view preview (ff09b87)

Translated pages in this PR:

• python_by_example.html

[adisankarmt]

python_by_example review completed. Overall the tool is performing well. Need some changes on word order, verb forms, and such small things.

[adisankarmt]

python_by_example review completed. Overall the tool is performing well. Need some changes on word order, verb forms, and such small things.

[mmcky]

Thank you @adisankarmt — this is exactly the review round the calibration phase was waiting for. All 100 of your comments are now applied to this PR in commit 6ee7130, each "Preferred:" rendering taken verbatim.

A few notes on how they were applied:

• Typography restored where the plain-text comments dropped it: code formatting on ϵ_values, ts_length, for, f'foo{var}'; the {doc} link on the first NumPy mention (line 94); the bold on subpackage (line 155); straight quotes and single spacing.
• Retain-in-English rulings (lines 106, 471, 489, 570, 583, 639, and the Exercise 5 hint and solution sections) use the English text byte-exact from the source lecture, so future syncs diff cleanly.

Three small things I'd ask you to double-check in the updated preview once it rebuilds:

1. Line 381: your comment read "ഏറ്റവും common ആയ ഉപയോഗിക്കുന്ന technique" — I applied it as "ഏറ്റവും common ആയി ഉപയോഗിക്കുന്ന technique" on the assumption ആയ was a typo for the adverbial ആയി. Please correct me if the original was intended.
2. Line 361–363: your two comments there drop the "ഇത്" lead-in before the bullet list — please confirm the second bullet (brackets/end-statements clutter) still reads naturally without it.
3. Line 131: your preferred sentence began with lowercase "share"; I capitalised it as the sentence opener.

Since your role on this repository is now write access, you can push corrections directly to this branch — and in future review rounds you can use GitHub's suggestion blocks in review comments, which lets us apply your fix with one click and credits you as the commit author automatically.

Your flags now feed the next glossary and rule update for the translation tool (the below-deixis pattern, ആദ്യത്തെ, the discourse connectives, and your proposed rule for mathematical Hint/Solution sections are all being encoded), tracked in QuantEcon/action-translation#189. The reviews of the other four lectures (PRs #2–#5) can proceed whenever suits you — no deadline.

[github-actions]

📖 HTML build - view preview (6ee7130)

Translated pages in this PR:

• python_by_example.html

[mmcky]

@adisankarmt — a quick status and what would help next, now that your entire round-1 review has been folded into the translation tool:

What your 100 comments changed. Every flag was encoded as a glossary entry or a rule (or logged accepted-as-is) and shipped in QuantEcon/action-translation#272. We then regenerated this lecture from scratch with the updated tool as a check: the fresh output now uses താഴെ കാണാം for below-pointers, ആദ്യത്തെ, നിന്നും, keeps "On the other hand" in English, drops every calque you flagged, and renders the Exercise 5 hint and solution wholly in English per your recommendation (which Matt accepted as policy). Your review measurably moved the machine's register — thank you.

Two things when you have a moment:

1. Verify the three small judgement calls from the earlier application comment above: line 381 (ആയ → ആയി), lines 361–363 (the dropped "ഇത്" lead-in before the bullets), and line 131 (capitalised "Share"). A 👍 or a correction on each is plenty.
2. Round 2 is ready: Malayalam translation: functions — calibration review round 2 (v0.3 rules) #7 (functions) — regenerated with the updated tool, so it should already read much closer to your register; your comments there will catch what the round-1 rules missed. The old Malayalam translation: functions — native-speaker calibration review #2–Malayalam translation: numpy — native-speaker calibration review #5 are closed (they predate your rulings); each remaining lecture will get a fresh PR generated with the then-current tool when its round comes. Since you now have write access, GitHub's suggestion blocks (or direct pushes to the branch) will let your fixes land with one click, credited to you.

No deadline on any of this — the pace is yours.

[adisankarmt]

1. ആയ was a typo. ആയി is correct.
2. It makes sense, but please do not make it a rule now. Let me review the upcoming lectures and I will be able to resolve this doubt regarding "ഇത്".
3. "share" should be capitalised it as the sentence opener. I might have missed it.

[mmcky]

Thanks @adisankarmt — all three confirmed, nothing further to change here. On (2): agreed, the "ഇത്" lead-in is not encoded as a rule — the round-1 update to the tool (QuantEcon/action-translation#272) took the below-deixis pattern, the connectives and the calques, but left this one open. Whatever you conclude across the next lectures will set it.

On the font: good catch, and the right diagnosis. The theme's fonts (Source Sans Pro / PT Serif) have no Malayalam glyphs, so the Malayalam was being drawn by your operating system's fallback font, which sits larger than the Latin. #9 adds Noto Sans Malayalam for body text and Noto Serif Malayalam for headings, applied to the Malayalam characters only, so the English and code are unchanged. Once its preview build posts, could you compare it with the current site and say whether the size now looks balanced? If it is still off, the Malayalam alone can be scaled a few percent either way without touching anything else.

Enjoy #7 — keen to hear how the regenerated output reads.

[github-actions]

📖 HTML build - view preview (c4378e7)

Translated pages in this PR:

• python_by_example.html

[adisankarmt]

small punctuations mistakes and last minute errors rectified

[github-actions]

📖 HTML build - view preview (7605f27)

Translated pages in this PR:

• python_by_example.html

[mmcky]

thanks @adisankarmt for all your work here. Merging now and will publish.