Skip to content

Complete and revise the Brazilian Portuguese audio course (units 0–8) - #253

Open
prof-ramos wants to merge 10 commits into
huggingface:mainfrom
prof-ramos:codex/traducao-pt-br-unidades-0-3
Open

prof-ramos wants to merge 10 commits into
huggingface:mainfrom
prof-ramos:codex/traducao-pt-br-unidades-0-3

Conversation

@prof-ramos

@prof-ramos prof-ramos commented Oct 10, 2026 •

Copy link
Copy Markdown

The Portuguese course previously covered only units 0–1. This PR revises those 10 sections, translates the remaining 40 across units 2–8 and events, and completes the Portuguese table of contents against English reference 56b6e8334aef7e0efa0137574f068c968f3f6e1c. Code examples, recorded outputs, model identifiers, URLs and quiz answer logic are preserved. Presentation fixes make literal tokens, quiz emphasis and tip content render correctly.

Related to #173. Translation and separate comparative and linguistic review passes were performed with Codex; this is not an independent human review. All 50 sections are translated and textually reviewed. To keep this PR limited to course content, the glossary, per-section progress, invariant checker (verificar.py) and validation report are not included here; they live in the fork branch https://github.com/prof-ramos/audio-transformers-course/tree/traducao-pt-br-ferramentas .

This translation was AI-assisted (Codex) and has not yet had an independent native-speaker review; a native PT-BR reviewer from #173 would be very welcome.

Validation repeated on 2026-10-12:

  • make quality passed across the repository.
  • verificar.py --complete (in the fork tooling branch) passed for all 50 sections: code/output blocks, URLs, heading counts, index order and quiz structure.
  • The translation validator reports no missing sections; pip check passed.
  • All 21 Portuguese notebooks were regenerated in a fresh directory and passed nbformat schema validation. ML cells were not executed.
  • English and other language sources remain unchanged; the upstream English reference still matches the translation baseline.

Earlier validation recorded in relatorio.md and evidencias.json (in the fork tooling branch): full pt-BR doc-builder compilation; all 50 browser routes returning HTTP 200 with no page JavaScript errors; visual inspection of every page; all 41 alternatives across 14 quiz questions exercised; notebook code and recorded outputs checked against the chapters. These browser/build checks were not repeated during the submission pass.

Limitations: remote images, audio and embeds could not be inspected in the earlier restricted environment; two broken relative links inherited from English are documented and preserved. Generic renderer controls and notebook-generator boilerplate remain in English. Original technical inconsistencies are recorded separately. A local KaTeX CSS workaround affected only the earlier preview kit, not the course files or deployed renderer. These limits remain disclosed for maintainer review. This submission covers documentation and does not guarantee the operation of external services.

The translation is ready for maintainer review. No merge or deployment is included.

@prof-ramos prof-ramos changed the title Codex/traducao pt br unidades 0 3 Complete and revise the Brazilian Portuguese audio course (units 0–8) Oct 12, 2026
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.

2 participants