rust-lang / rust-lang/rust-by-example
Brazilian Portuguese Translation
Nobody has claimed this yet.
- Dominant language
- Handlebars
- Stars
- 8.1k
- Forks
- 1.6k
- PR merge metrics
- No merged PRs in 30d
Description
Add Brazilian Portuguese Translation Guide Documentation
This issue tracks the addition of documentation for Brazilian Portuguese contributors who want to translate Rust by Example using the mdbook-i18n-helpers workflow.
Related PR:
Summary
The proposed documentation introduces a complete translation workflow guide for Brazilian Portuguese contributors, including:
- Installation and setup of required translation tools
- Commands for creating and updating translation files
- Instructions for managing translation resources
- Guidance for compiling the translated book locally
- Translation progress tracking recommendations
Integration Details
The guide also documents how to properly register new language translations across the project configuration, including updates to:
.github/workflows/rbe.ymltheme/head.hbssrc/bootstrap/src/core/build_steps/doc.rs
Motivation
Currently, there is limited onboarding documentation for contributors interested in translating Rust by Example into Brazilian Portuguese. This guide helps standardize the workflow and lowers the barrier for new translators contributing to the project.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Review related PR #2014 first, then inspect .github/workflows/rbe.yml, theme/head.hbs, and src/bootstrap/src/core/build_steps/doc.rs for existing translation registration. The documentation is done when it covers tool setup, translation-file commands, resource management, local book compilation, progress tracking, and the required registration steps for Brazilian Portuguese contributors.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- handlebars, rust
- Domain
- documentation, internationalization, localization
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 35/100